# @lambdacurry/event-bus-redis

> Redis Event Bus Module for Medusa

Latest version **1.8.16** (published 2025-05-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install @lambdacurry/event-bus-redis
pnpm add @lambdacurry/event-bus-redis
yarn add @lambdacurry/event-bus-redis
bun add @lambdacurry/event-bus-redis
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: has types; no vulnerabilities; high maintenance score; high quality score; popular repo.

Warnings: low downloads; no esm support.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 1.8.16 |
| Published | 2025-05-22 |
| First published | 2024-04-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=16 |
| Dependencies | 5 |
| Unpacked size | 26.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 36140 |
| Author | Medusa |
| Maintainers | jaruesink, dwene, cyberdude, bfunk54, antony-lambdacurry, lcmohsen |

## Links

- npm: https://www.npmjs.com/package/@lambdacurry/event-bus-redis
- Repository: https://github.com/medusajs/medusa
- Homepage: https://github.com/medusajs/medusa#readme
- Issues: https://github.com/medusajs/medusa/issues
- npm.io page: https://npm.io/package/@lambdacurry/event-bus-redis

## Dependencies (5)

- [awilix](https://npm.io/package/awilix.md) ^8.0.0
- [bullmq](https://npm.io/package/bullmq.md) ^5.4.2
- [ioredis](https://npm.io/package/ioredis.md) ^5.2.5
- [@medusajs/utils](https://npm.io/package/@medusajs/utils.md) ^1.11.8
- [@medusajs/modules-sdk](https://npm.io/package/@medusajs/modules-sdk.md) ^1.12.10

## Recent versions

- 1.8.16 (latest) — 2025-05-22
- 1.8.15 — 2024-04-18
- 1.8.14 — 2024-04-18
- 1.8.13 — 2024-04-18
- 1.8.12 — 2024-04-18

## README

<p align="center">
  <a href="https://www.medusajs.com">
    <img alt="Medusa" src="https://user-images.githubusercontent.com/7554214/153162406-bf8fd16f-aa98-4604-b87b-e13ab4baf604.png" width="100" />
  </a>
</p>
<h1 align="center">
  @medusajs/event-bus-redis
</h1>

<h4 align="center">
  <a href="https://docs.medusajs.com">Documentation</a> |
  <a href="https://www.medusajs.com">Website</a>
</h4>

<p align="center">
An open source composable commerce engine built for developers.
</p>
<p align="center">
  <a href="https://github.com/medusajs/medusa/blob/master/LICENSE">
    <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="Medusa is released under the MIT license." />
  </a>
  <a href="https://circleci.com/gh/medusajs/medusa">
    <img src="https://circleci.com/gh/medusajs/medusa.svg?style=shield" alt="Current CircleCI build status." />
  </a>
  <a href="https://github.com/medusajs/medusa/blob/master/CONTRIBUTING.md">
    <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat" alt="PRs welcome!" />
  </a>
    <a href="https://www.producthunt.com/posts/medusa"><img src="https://img.shields.io/badge/Product%20Hunt-%231%20Product%20of%20the%20Day-%23DA552E" alt="Product Hunt"></a>
  <a href="https://discord.gg/xpCwq3Kfn8">
    <img src="https://img.shields.io/badge/chat-on%20discord-7289DA.svg" alt="Discord Chat" />
  </a>
  <a href="https://twitter.com/intent/follow?screen_name=medusajs">
    <img src="https://img.shields.io/twitter/follow/medusajs.svg?label=Follow%20@medusajs" alt="Follow @medusajs" />
  </a>
</p>

## Overview

Redis Event Bus module for Medusa. When installed, the events system of Medusa is powered by BullMQ and `io-redis`. BullMQ is responsible for the message queue and worker. `io-redis` is the underlying Redis client, that BullMQ connects to for events storage.

## Getting started

Install the module:

```bash
yarn add @medusajs/event-bus-redis
```

Add the module to your `medusa-config.js`:

```js
module.exports = {
  // ...
  modules: [
    {
      resolve: "@medusajs/event-bus-redis",
      options: {
        redisUrl: "redis:.."
      },
    },
  ],
  // ...
}
```

## Configuration

The module can be configured with the following options:

| Option    | Type       | Description                                                                                                                                             | Default     |
| --------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| `redisUrl`  | `string`  | URL of the Redis instance to connect to.                                                                                              | `events-worker` |
| `queueName`   | `string?` | Name of the BullMQ queue.                                                                                                            | `events-queue`      |
| `queueOptions`    | `object?`  | Options for the BullMQ queue. See BullMQ's [documentation](https://api.docs.bullmq.io/interfaces/QueueOptions.html). | `{}`     |
| `redisOptions` | `object?`  | Options for the Redis instance. See `io-redis`'s [documentation](https://luin.github.io/ioredis/index.html#RedisOptions)                                                | `{}` |

**Info**: See how the options are applied in the [RedisEventBusService](https://github.com/medusajs/medusa/blob/0c1d1d590463fa30b083c4312293348bdf6596be/packages/event-bus-redis/src/services/event-bus-redis.ts#L52) and [loader](https://github.com/medusajs/medusa/blob/0c1d1d590463fa30b083c4312293348bdf6596be/packages/event-bus-redis/src/loaders/index.ts).

If you do not provide a `redisUrl` in the module options, the server will fail to start.

---
_Source: https://npm.io/package/@lambdacurry/event-bus-redis · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._