docs: triage issues + revamp troubleshooting guides (#14216)

* docs: triage issues + revamp troubleshooting guides * small change
2025-12-04 17:12:48 +02:00
parent a00bba5cfc
commit e3e3c725db
23 changed files with 126 additions and 69 deletions
@@ -28,7 +28,7 @@ While this is the recommended way to create a Medusa application, you can altern

 <Prerequisites items={[
  {
-    text: "Node.js v20+ (LTS versions)",
+    text: "Node.js v20+ (LTS versions only)",
    link: "https://nodejs.org/en/download"
  },
  {
@@ -36,7 +36,7 @@ While this is the recommended way to create a Medusa application, you can altern
    link: "https://git-scm.com/downloads"
  },
  {
-    text: "PostgreSQL",
+    text: "PostgreSQL installed and running",
    link: "https://www.postgresql.org/download/"
  }
 ]} />
@@ -96,7 +96,7 @@ export const generatedEditDates = {
  "app/learn/build/page.mdx": "2025-10-27T09:30:26.957Z",
  "app/learn/deployment/general/page.mdx": "2025-10-21T07:39:08.998Z",
  "app/learn/fundamentals/workflows/multiple-step-usage/page.mdx": "2025-08-01T14:59:59.501Z",
-  "app/learn/installation/page.mdx": "2025-11-26T12:14:47.372Z",
+  "app/learn/installation/page.mdx": "2025-12-04T14:30:00.510Z",
  "app/learn/fundamentals/data-models/check-constraints/page.mdx": "2025-07-25T13:50:21.065Z",
  "app/learn/fundamentals/module-links/link/page.mdx": "2025-11-28T13:42:03.037Z",
  "app/learn/fundamentals/workflows/store-executions/page.mdx": "2025-04-17T08:29:10.166Z",
@@ -25386,9 +25386,9 @@ While this is the recommended way to create a Medusa application, you can altern

 ### Prerequisites

- [Node.js v20+ (LTS versions)](https://nodejs.org/en/download)
+- [Node.js v20+ (LTS versions only)](https://nodejs.org/en/download)
 - [Git CLI tool](https://git-scm.com/downloads)
- [PostgreSQL](https://www.postgresql.org/download/)
+- [PostgreSQL installed and running](https://www.postgresql.org/download/)

 To create a Medusa application, use the `create-medusa-app` command:

@@ -46123,7 +46123,7 @@ const step1 = createStep(
  "step-1",
  async ({}, { container }) => {
    const eventModuleService = container.resolve(
-      Modules.EVENT
+      Modules.EVENT_BUS
    )

    await eventModuleService.emit({
@@ -46162,7 +46162,7 @@ Medusa provides the following Event Modules. You can use one of them, or [Create

 The Redis Event Module uses Redis to implement Medusa's pub/sub events system.

-It's powered by BullMQ and `io-redis`. BullMQ is responsible for the message queue and worker, and `io-redis` is the underlying Redis client that BullMQ connects to for events storage.
+It's powered by [BullMQ](https://bullmq.io/) and `io-redis`. BullMQ is responsible for the message queue and worker, and `io-redis` is the underlying Redis client that BullMQ connects to for events storage.

 In production, it's recommended to use this module.

@@ -46190,6 +46190,19 @@ module.exports = defineConfig({
      resolve: "@medusajs/medusa/event-bus-redis",
      options: { 
        redisUrl: process.env.EVENTS_REDIS_URL,
+        // suggested additional options for production use
+        jobOptions: {
+          removeOnComplete: {
+            // keep jobs for 1 hour or up to 1000 jobs
+            age: 3600,
+            count: 1000,
+          },
+          removeOnFail: {
+            // keep jobs for 1 hour or up to 1000 jobs
+            age: 3600,
+            count: 1000,
+          }
+        }
      },
    },
  ],
@@ -45,7 +45,7 @@ const step1 = createStep(
  "step-1",
  async ({}, { container }) => {
    const eventModuleService = container.resolve(
-      Modules.EVENT
+      Modules.EVENT_BUS
    )

    await eventModuleService.emit({
@@ -8,7 +8,7 @@ export const metadata = {

 The Redis Event Module uses Redis to implement Medusa's pub/sub events system.

-It's powered by BullMQ and `io-redis`. BullMQ is responsible for the message queue and worker, and `io-redis` is the underlying Redis client that BullMQ connects to for events storage.
+It's powered by [BullMQ](https://bullmq.io/) and `io-redis`. BullMQ is responsible for the message queue and worker, and `io-redis` is the underlying Redis client that BullMQ connects to for events storage.

 In production, it's recommended to use this module.

@@ -47,6 +47,19 @@ module.exports = defineConfig({
      resolve: "@medusajs/medusa/event-bus-redis",
      options: { 
        redisUrl: process.env.EVENTS_REDIS_URL,
+        // suggested additional options for production use
+        jobOptions: {
+          removeOnComplete: {
+            // keep jobs for 1 hour or up to 1000 jobs
+            age: 3600,
+            count: 1000,
+          },
+          removeOnFail: {
+            // keep jobs for 1 hour or up to 1000 jobs
+            age: 3600,
+            count: 1000,
+          }
+        }
      },
    },
  ],
@@ -28,12 +28,12 @@ To register a customer, you implement the following steps:

 1. Show the customer a form to enter their details.
 2. Send a `POST` request to the `/auth/customer/emailpass/register` [Get Registration Token](!api!/store#auth_postactor_typeauth_provider_register) API route to obtain a registration JWT token.
-3. Send a request to the [Create Customer API route](!api!/store#customers_postcustomers) passing the registration JWT token in the header.
+3. Send a request to the [Register Customer API route](!api!/store#customers_postcustomers) passing the registration JWT token in the header.

 However, a customer may enter an email that's already used either by an admin user, another customer, or a [custom actor type](../../../commerce-modules/auth/auth-identity-and-actor-types/page.mdx). To handle this scenario:

 - Try to obtain a login token by sending a `POST` request to the `/auth/customer/emailpass` [Authenticate Customer](!api!/store#auth_postactor_typeauth_provider) API route. The customer is only allowed to register if their email and password match the existing identity. This allows admin users to log in or register as customers.
- If you obtained the login token successfully, create the customer using the login JWT token instead of the registration token. This will not remove the existing identity. So, for example, an admin user can also become a customer.
+- If you obtained the login token successfully, register the customer using the login JWT token instead of the registration token. This will not remove the existing identity. So, for example, an admin user can also become a customer.

 When you're using the JS SDK, this flow is simplified with quick registration and login methods. The rest of this guide uses the JS SDK to demonstrate the registration flow. However, if you're not using the JS SDK, you can still implement the same flow using the API routes.

@@ -186,7 +186,7 @@ export const fetchHighlights = [
  ["11", "catch", "Maybe another identity exists with the same email."],
  ["21", "login", "Try to obtain a login JWT token."],
  ["24", "catch", "The existing account belongs to another customer, so authentication failed."],
-  ["40", "create", "Send a request to create the customer."],
+  ["40", "create", "Send a request to register the customer."],
  ["47", "TODO", "Redirect the customer to the log in page."],
  ["48", "catch", "Handle registration failure"],
 ]
@@ -211,7 +211,7 @@ export const fetchHighlights = [
      }
      // another identity (for example, admin user)
      // exists with the same email. So, use the auth
-      // flow to login and create a customer.
+      // flow to login and register a customer.
      const loginResponse = (await sdk.auth.login("customer", "emailpass", {
        email,
        password,
@@ -229,7 +229,7 @@ export const fetchHighlights = [
      }
    }

-    // create customer
+    // register customer
    try {
      const { customer } = await sdk.store.customer.create({
        first_name: firstName,
@@ -256,7 +256,7 @@ In the above example, you create a `handleRegistration` function that:
    - If the error is an existing identity error, try retrieving the login JWT token from `/auth/customer/emailpass` API route using the `auth.login` method. This will fail if the existing identity has a different password, which doesn't allow the customer from registering.
    - For other errors, show an alert and exit execution.
    - The JS SDK automatically stores an re-uses the authentication headers or session in the `auth.register` and `auth.login` methods. So, if you're not using the JS SDK, make sure to pass the received authentication tokens as explained in the [API reference](!api!/store#1-bearer-authorization-with-jwt-tokens)
- Send a request to the [Create Customer API route](!api!/store#customers_postcustomers) to create the customer in Medusa.
+- Send a request to the [Register Customer API route](!api!/store#customers_postcustomers) to register the customer in Medusa.
    - If an error occurs, show an alert and exit execution.
    - As mentioned, the JS SDK automatically sends the authentication headers or session in all requests after registration or logging in. If you're not using the JS SDK, make sure to pass the received authentication tokens as explained in the [API reference](!api!/store#1-bearer-authorization-with-jwt-tokens).
 - Once the customer is registered successfully, you can either redirect the customer to the login page or log them in automatically, as explained in the [Login](../login/page.mdx) guide.
@@ -1,18 +1,26 @@
-You may get the following error while running `medusa new`:
+When installing or running Medusa, you may get errors while Medusa tries to connect to your PostgreSQL database.
+
+For example, you may get one of the following errors:

 ```bash
+Error: connect ECONNREFUSED ::1:5432
 Error: SASL: SCRAM-SERVER-FIRST-MESSAGE: client password must be a string
 ```

-If the error occurs while running `medusa new` and you've selected to enter your database credentials, either:
+### Error During Installation

-1. Make sure your database credentials are correct;
-2. Or choose the Skip option to skip entering your database credentials.
+If the connectivity error occurs while running `create-medusa-app`, it means you passed incorrect database credentials when prompted during the installation. Make sure that:

-If the error occurs while running integration tests, make sure the following variable is set in your system's environment variable:
+1. PostgreSQL is installed and running on your machine;
+2. Your PostgreSQL server is configured at `localhost:5432` (the default host and port); If not, you can pass the `--db-url <url>` flag to the `create-medusa-app` command to specify a custom database URL;
+3. You're passing correct username and password for your PostgreSQL database;
+4. You're using a user that has privileges to create new databases;
+5. You're passing correct database name for your PostgreSQL user. It should have the same name as your PostgreSQL user by default.

-```bash
-DB_HOST=<YOUR_DB_HOST>
-DB_USERNAME=<YOUR_DB_USERNAME>
-DB_PASSWORD=<YOUR_PASSWORD>
-```
+### Error During Development
+
+If the error occurs while running integration tests, make sure that:
+
+1. The `DATABASE_URL` environment variable is set correctly in your `.env` file;
+2. The [projectConfig.databaseUrl](!docs!/learn/configurations/medusa-config#databaseurl) field in your `medusa-config.js` file is set to the `DATABASE_URL` environment variable;
+3. The database URL is using correct username and password, and points to a running PostgreSQL database instance.
@@ -5,6 +5,8 @@ import InvalidTokenError from "../_sections/create-medusa-app-errors/no-browser-
 import DockerSection from "../_sections/database-errors/docker.mdx"
 import DbUrlError from "../_sections/create-medusa-app-errors/db-url-error.mdx"
 import ForwardingError from "../_sections/create-medusa-app-errors/forwarding.mdx"
+import SaslSection from '../_sections/database-errors/sasl.mdx'
+import ModuleXErrorSection from '../_sections/common-installation-errors/module-x-error.mdx'

 export const metadata = {
  title: `Common create-medusa-app Errors`,
@@ -12,6 +14,14 @@ export const metadata = {

 # {metadata.title}

+This troubleshooting guide covers common errors you may encounter when using the `create-medusa-app` command to set up a new Medusa application and how to resolve them.
+
+## General Errors Connecting to Database
+
+<SaslSection />
+
+---
+
 ## TypeError: cmd is not a function

 <TypeError />
@@ -48,6 +58,12 @@ export const metadata = {

 ---

+## Resolve "Cannot find module X" Errors
+
+<ModuleXErrorSection />
+
+---
+
 ## Other Errors

 <OtherErrors />
@@ -1,6 +1,5 @@
 import SaslSection from '../_sections/database-errors/sasl.mdx'
 import ConnectionErrorSection from '../_sections/database-errors/connection-error.mdx'
-import PrivilegesSection from '../_sections/database-errors/privileges.mdx'
 import DockerSection from "../_sections/database-errors/docker.mdx"

 export const metadata = {
@@ -9,24 +8,14 @@ export const metadata = {

 # {metadata.title}

-## Can't Connect to PostgreSQL Docker Container
+This troubleshooting guide covers common database errors you may encounter when working with Medusa and how to resolve them.

-<DockerSection />
-
---
-
-## Error: SASL: SCRAM-SERVER-FIRST-MESSAGE: Client password must be a string
+## General Errors Connecting to Database

 <SaslSection />

 ---

-## Error: connect ECONNREFUSED ::1:5432
+## Can't Connect to PostgreSQL Docker Container

-<ConnectionErrorSection />
-
---
-
-## Database User Privileges
-
-<PrivilegesSection />
+<DockerSection />
@@ -1,15 +1,19 @@
 export const metadata = {
-  title: `Errors After Upgrading`,
+  title: `Errors After Upgrading Medusa`,
 }

 # {metadata.title}

-If you run into errors after updating Medusa and its dependencies, it's highly recommended to check the Upgrade Guides if there is a specific guide for your version. These guides include steps required to perform after upgrading Medusa.
+If you run into errors after updating your Medusa application, it's highly recommended to check the [GitHub Release Notes](https://github.com/medusajs/medusa/releases) for any upgrade guides related to the version you upgraded to. These release notes may include details on breaking changes and how to resolve them before upgrading.

-If there's no upgrade guide for your version, make sure that you ran the `db:migrate` command in the root directory of your Medusa application:
+Also, after updating your Medusa application, make sure that you ran the `db:migrate` command in the root directory of your Medusa application:

 ```bash
 npx medusa db:migrate
 ```

 This ensures your application has the latest database structure required. Then, try running your Medusa application again and check whether the same error occurs.
+
+## Additional Resources
+
+- [Updating Medusa](!docs!/learn/update)
@@ -8,7 +8,7 @@ export const metadata = {

 # {metadata.title}

-In this document, you can find solutions to some common problems that occur when installing Medusa’s CLI Tool.
+This troubleshooting guide covers common errors you may encounter when installing the Medusa CLI and how to resolve them.

 ## NPM Error: EACCES Permissions Errors

@@ -6,6 +6,8 @@ export const metadata = {

 # {metadata.title}

+This troubleshooting guide covers general errors you may encounter while installing or developing with Medusa and how to resolve them.
+
 ## Resolve "Cannot find module X" Errors

 <ModuleXErrorSection />
@@ -4,7 +4,7 @@ export const metadata = {

 # {metadata.title}

-This guide provides some troubleshooting step as to why your admin widget / UI route isn't showing in the Medusa Admin dashboard.
+This troubleshooting guide covers common reasons why an admin widget or UI route may not be showing in your Medusa Admin and how to resolve them.

 ## Incorrect Zone

@@ -6,6 +6,8 @@ export const metadata = {

 # {metadata.title}

+This troubleshooting guide covers common errors you may encounter when using payment providers in your Medusa application and how to resolve them.
+
 ## Unknown Error for Zero Cart Total

 <ZeroTotalError />
@@ -2,11 +2,13 @@ import S3BucketAcl from "../_sections/s3/aws-bucket-acl.mdx"
 import CloudflareChecksum from "../_sections/s3/cloudflare-checksum.mdx"

 export const metadata = {
-  title: `S3 Module Provider Errors`,
+  title: `S3 File Module Provider Errors`,
 }

 # {metadata.title}

+This troubleshooting guide covers common errors you may encounter when using the [S3 File Module Provider](../../infrastructure-modules/file/s3/page.mdx) in your Medusa application and how to resolve them.
+
 ## AWS: The bucket does not allow ACLs

 <S3BucketAcl />
@@ -7,7 +7,7 @@ export const metadata = {

 # {metadata.title}

-This guide helps you troubleshoot issues when a scheduled job in your Medusa application is not running, or running at unexpected times.
+This troubleshooting guide helps you troubleshoot issues when a scheduled job in your Medusa application is not running, or running at unexpected times.

 ## Confirm Job is Set Up Correctly

@@ -7,7 +7,7 @@ export const metadata = {

 # {metadata.title}

-This guide helps you troubleshoot issues when subscribers in your Medusa application are not running.
+This troubleshooting guide helps you troubleshoot issues when subscribers in your Medusa application are not running.

 ## Confirm Event is Emitted

@@ -1,9 +1,11 @@
 export const metadata = {
-  title: `Test Errors`,
+  title: `Errors When Running Tests`,
 }

 # {metadata.title}

+This troubleshooting guide covers common errors you may encounter when running tests in your Medusa application and how to resolve them.
+
 ## Loaders for module Workflows failed

 If you get the following error when running your tests:
@@ -23,10 +25,16 @@ module.exports = {

 Then, create the `integration-tests/setup.js` file with the following content:

+<Note>
+
+If you're using a version prior to Medusa v2.11.0, change `@medusajs/framework/mikro-orm/core` to `@mikro-orm/core`. Learn more in the [v2.11.0 codemod](!docs!/learn/codemods/replace-imports).
+
+</Note>
+
 ```js title="integration-tests/setup.js"
 const { MetadataStorage } = require("@medusajs/framework/mikro-orm/core")

 MetadataStorage.clear()
 ```

-Learn more about configuring test tools in [this documentation](!docs!/learn/debugging-and-testing/testing-tools)
+Refer to the [Testing Tools](!docs!/learn/debugging-and-testing/testing-tools) guide for more details.
@@ -151,7 +151,7 @@ export const generatedEditDates = {
  "app/storefront-development/customers/log-out/page.mdx": "2025-03-27T14:45:23.360Z",
  "app/storefront-development/customers/login/page.mdx": "2025-03-28T08:38:37.694Z",
  "app/storefront-development/customers/profile/page.mdx": "2025-03-27T14:47:14.251Z",
-  "app/storefront-development/customers/register/page.mdx": "2025-03-28T09:30:47.216Z",
+  "app/storefront-development/customers/register/page.mdx": "2025-12-04T13:42:00.322Z",
  "app/storefront-development/customers/retrieve/page.mdx": "2025-03-27T14:41:39.996Z",
  "app/storefront-development/customers/page.mdx": "2024-06-13T12:21:54+03:00",
  "app/storefront-development/products/categories/list/page.mdx": "2025-03-27T14:46:51.437Z",
@@ -178,13 +178,13 @@ export const generatedEditDates = {
  "app/storefront-development/tips/page.mdx": "2025-03-26T10:31:43.816Z",
  "app/storefront-development/page.mdx": "2025-03-27T13:28:22.077Z",
  "app/troubleshooting/cors-errors/page.mdx": "2024-05-03T17:36:38+03:00",
-  "app/troubleshooting/create-medusa-app-errors/page.mdx": "2024-07-11T10:29:13+03:00",
-  "app/troubleshooting/database-errors/page.mdx": "2024-05-03T17:36:38+03:00",
+  "app/troubleshooting/create-medusa-app-errors/page.mdx": "2025-12-04T14:12:21.480Z",
+  "app/troubleshooting/database-errors/page.mdx": "2025-12-04T14:14:46.745Z",
  "app/troubleshooting/eaddrinuse/page.mdx": "2024-05-03T17:36:38+03:00",
-  "app/troubleshooting/errors-after-upgrading/page.mdx": "2024-07-11T10:29:13+03:00",
-  "app/troubleshooting/errors-installing-cli/page.mdx": "2024-05-03T17:36:38+03:00",
-  "app/troubleshooting/general-errors/page.mdx": "2024-05-03T17:36:38+03:00",
-  "app/troubleshooting/s3/page.mdx": "2025-01-24T13:47:24.994Z",
+  "app/troubleshooting/errors-after-upgrading/page.mdx": "2025-12-04T14:08:49.980Z",
+  "app/troubleshooting/errors-installing-cli/page.mdx": "2025-12-04T14:12:46.607Z",
+  "app/troubleshooting/general-errors/page.mdx": "2025-12-04T14:13:18.170Z",
+  "app/troubleshooting/s3/page.mdx": "2025-12-04T14:16:44.529Z",
  "app/troubleshooting/page.mdx": "2025-03-10T13:54:11.701Z",
  "app/page.mdx": "2025-02-26T10:23:58.440Z",
  "app/commerce-modules/auth/_events/_events-table/page.mdx": "2024-07-03T19:27:13+03:00",
@@ -203,7 +203,7 @@ export const generatedEditDates = {
  "app/commerce-modules/api-key/_events/page.mdx": "2024-07-03T19:27:13+03:00",
  "app/commerce-modules/api-key/_events/_events-table/page.mdx": "2024-07-03T19:27:13+03:00",
  "app/infrastructure-modules/cache/redis/page.mdx": "2025-06-24T08:50:10.115Z",
-  "app/infrastructure-modules/event/redis/page.mdx": "2025-06-24T08:50:10.115Z",
+  "app/infrastructure-modules/event/redis/page.mdx": "2025-12-04T13:38:38.038Z",
  "app/infrastructure-modules/event/local/page.mdx": "2025-03-27T14:53:13.309Z",
  "app/infrastructure-modules/workflow-engine/in-memory/page.mdx": "2024-11-19T16:37:47.262Z",
  "app/infrastructure-modules/cache/in-memory/page.mdx": "2024-11-19T16:37:47.261Z",
@@ -211,7 +211,7 @@ export const generatedEditDates = {
  "app/infrastructure-modules/file/local/page.mdx": "2025-05-20T07:51:40.714Z",
  "app/infrastructure-modules/notification/send-notification/page.mdx": "2025-05-20T07:51:40.714Z",
  "app/infrastructure-modules/file/page.mdx": "2025-04-17T08:29:00.672Z",
-  "app/infrastructure-modules/event/page.mdx": "2025-04-17T08:29:00.488Z",
+  "app/infrastructure-modules/event/page.mdx": "2025-12-04T13:39:18.058Z",
  "app/infrastructure-modules/cache/create/page.mdx": "2025-03-27T14:53:13.309Z",
  "app/admin-widget-injection-zones/page.mdx": "2025-08-28T16:47:14.680Z",
  "app/infrastructure-modules/notification/page.mdx": "2025-06-25T10:48:23.838Z",
@@ -228,7 +228,7 @@ export const generatedEditDates = {
  "references/core_flows/core_flows.Order/page.mdx": "2025-05-20T07:51:40.872Z",
  "references/modules/core_flows/page.mdx": "2025-12-01T18:32:50.036Z",
  "references/types/types.HttpTypes/page.mdx": "2025-12-01T18:33:00.207Z",
-  "app/troubleshooting/medusa-admin/no-widget-route/page.mdx": "2025-03-11T08:57:17.255Z",
+  "app/troubleshooting/medusa-admin/no-widget-route/page.mdx": "2025-12-04T14:17:42.819Z",
  "references/auth/IAuthModuleService/methods/auth.IAuthModuleService.createProviderIdentities/page.mdx": "2025-10-21T08:10:42.895Z",
  "references/auth/IAuthModuleService/methods/auth.IAuthModuleService.deleteProviderIdentities/page.mdx": "2025-10-21T08:10:42.902Z",
  "references/auth/IAuthModuleService/methods/auth.IAuthModuleService.listProviderIdentities/page.mdx": "2025-10-21T08:10:42.891Z",
@@ -5862,7 +5862,7 @@ export const generatedEditDates = {
  "references/types/interfaces/types.BaseProductTypeListParams/page.mdx": "2025-10-31T09:41:31.845Z",
  "references/core_flows/Order/Steps_Order/variables/core_flows.Order.Steps_Order.updateOrderChangesStepId/page.mdx": "2025-01-27T11:43:49.278Z",
  "app/commerce-modules/payment/account-holder/page.mdx": "2025-04-07T07:31:20.235Z",
-  "app/troubleshooting/test-errors/page.mdx": "2025-10-28T16:02:39.347Z",
+  "app/troubleshooting/test-errors/page.mdx": "2025-12-04T14:15:45.524Z",
  "app/commerce-modules/product/variant-inventory/page.mdx": "2025-04-25T13:25:02.408Z",
  "app/examples/guides/custom-item-price/page.mdx": "2025-11-28T08:30:59.896Z",
  "references/core_flows/Cart/Steps_Cart/functions/core_flows.Cart.Steps_Cart.validateShippingStep/page.mdx": "2025-04-11T09:04:35.729Z",
@@ -6018,7 +6018,7 @@ export const generatedEditDates = {
  "references/locking/interfaces/locking.ILockingProvider/page.mdx": "2025-10-21T08:10:48.914Z",
  "references/modules/locking/page.mdx": "2025-03-12T12:28:30.419Z",
  "references/cache/interfaces/cache.ICacheService/page.mdx": "2025-05-20T07:51:40.736Z",
-  "references/event/interfaces/event.IEventBusModuleService/page.mdx": "2025-10-21T08:10:43.967Z",
+  "references/event/interfaces/event.IEventBusModuleService/page.mdx": "2025-12-04T13:39:33.947Z",
  "references/file_service/interfaces/file_service.IFileModuleService/page.mdx": "2025-12-01T18:32:58.485Z",
  "references/modules/cache/page.mdx": "2025-03-17T15:24:02.572Z",
  "references/modules/event/page.mdx": "2025-03-17T15:24:03.021Z",
@@ -6546,7 +6546,7 @@ export const generatedEditDates = {
  "app/how-to-tutorials/tutorials/gift-message/page.mdx": "2025-06-26T09:13:19.296Z",
  "app/how-to-tutorials/tutorials/re-order/page.mdx": "2025-06-26T12:38:24.308Z",
  "app/commerce-modules/promotion/promotion-taxes/page.mdx": "2025-06-27T15:44:46.638Z",
-  "app/troubleshooting/payment/page.mdx": "2025-07-16T10:20:24.799Z",
+  "app/troubleshooting/payment/page.mdx": "2025-12-04T14:17:03.273Z",
  "app/recipes/personalized-products/example/page.mdx": "2025-11-28T10:13:26.457Z",
  "app/how-to-tutorials/tutorials/preorder/page.mdx": "2025-11-28T10:55:29.378Z",
  "references/js_sdk/admin/Order/methods/js_sdk.admin.Order.archive/page.mdx": "2025-12-01T18:33:10.588Z",
@@ -6559,7 +6559,7 @@ export const generatedEditDates = {
  "app/integrations/guides/payload/page.mdx": "2025-10-22T15:05:39.648Z",
  "references/js_sdk/admin/Client/methods/js_sdk.admin.Client.getToken/page.mdx": "2025-08-14T12:59:55.678Z",
  "app/commerce-modules/order/draft-orders/page.mdx": "2025-08-26T09:21:49.780Z",
-  "app/troubleshooting/scheduled-job-not-running/page.mdx": "2025-10-16T09:31:19.269Z",
+  "app/troubleshooting/scheduled-job-not-running/page.mdx": "2025-12-04T14:15:34.338Z",
  "app/troubleshooting/pnpm/page.mdx": "2025-08-29T12:21:24.692Z",
  "app/how-to-tutorials/tutorials/product-feed/page.mdx": "2025-10-02T10:24:52.283Z",
  "app/storefront-development/cart/manage-promotions/page.mdx": "2025-09-11T14:11:40.904Z",
@@ -6616,7 +6616,7 @@ export const generatedEditDates = {
  "app/storefront-development/production-optimizations/page.mdx": "2025-10-03T13:28:37.909Z",
  "app/how-to-tutorials/tutorials/category-images/page.mdx": "2025-11-07T08:55:59.228Z",
  "app/infrastructure-modules/caching/page.mdx": "2025-11-13T14:18:03.173Z",
-  "app/troubleshooting/subscribers/not-working/page.mdx": "2025-10-16T09:25:57.376Z",
+  "app/troubleshooting/subscribers/not-working/page.mdx": "2025-12-04T14:15:27.288Z",
  "references/js_sdk/admin/RefundReason/methods/js_sdk.admin.RefundReason.create/page.mdx": "2025-10-21T08:10:56.630Z",
  "references/js_sdk/admin/RefundReason/methods/js_sdk.admin.RefundReason.delete/page.mdx": "2025-10-21T08:10:56.634Z",
  "references/js_sdk/admin/RefundReason/methods/js_sdk.admin.RefundReason.retrieve/page.mdx": "2025-10-21T08:10:56.627Z",
@@ -309,7 +309,7 @@ const generatedgeneratedTroubleshootingSidebarSidebar = {
              "isPathHref": true,
              "type": "link",
              "path": "/troubleshooting/nextjs-starter-rewrites",
-              "title": "Cloud Run Error",
+              "title": "Google Cloud Run Error",
              "children": []
            }
          ]
@@ -31,7 +31,7 @@ const step1 = createStep(
  "step-1",
  async ({}, { container }) => {
    const eventModuleService = container.resolve(
-      Modules.EVENT
+      Modules.EVENT_BUS
    )
    
    // TODO use eventModuleService
@@ -205,7 +205,7 @@ export const troubleshootingSidebar = [
          {
            type: "link",
            path: "/troubleshooting/nextjs-starter-rewrites",
-            title: "Cloud Run Error",
+            title: "Google Cloud Run Error",
          },
        ],
      },
@@ -29,7 +29,7 @@ const step1 = createStep(
  "step-1",
  async ({}, { container }) => {
    const eventModuleService = container.resolve(
-      Modules.EVENT
+      Modules.EVENT_BUS
    )
    
    // TODO use eventModuleService