Back to Medusa

{metadata.title}

www/apps/resources/app/infrastructure-modules/event/local/page.mdx

2.14.21.1 KB
Original Source

export const metadata = { title: Local Event Module, }

{metadata.title}

The Local Event Module uses Node EventEmitter to implement Medusa's pub/sub events system. The Node EventEmitter is limited to a single process environment.

This module is useful for development and testing, but it’s not recommended to be used in production.

For production, it’s recommended to use modules like Redis Event Bus Module.


Register the Local Event Module

<Note>

The Local Event Module is registered by default in your application.

</Note>

Add the module into the modules property of the exported object in medusa-config.ts:

ts
import { Modules } from "@medusajs/framework/utils"

// ...

module.exports = defineConfig({
  // ...
  modules: [
    {
      resolve: "@medusajs/medusa/event-bus-local",
    },
  ],
})

Test the Module

To test the module, start the Medusa application:

bash
npm run dev

You'll see the following message in the terminal's logs:

bash
Local Event Bus installed. This is not recommended for production.