# rate-limit-redis
> A Redis store for the `express-rate-limit` middleware
Latest version **6.0.1** (published 2026-08-02) · MIT license · 0 weekly downloads
## Install
```sh
npm install rate-limit-redis
pnpm add rate-limit-redis
yarn add rate-limit-redis
bun add rate-limit-redis
```
## Health
**Score 75/100 (B)** — status: active.
Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.
Warnings: low downloads.
## Facts
| | |
|---|---|
| Version | 6.0.1 |
| Published | 2026-08-02 |
| First published | 2016-05-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >= 16 |
| Dependencies | 0 |
| Unpacked size | 42.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 218 |
| Author | Wyatt Johnson |
| Maintainers | nfriedly, wyattjoh, gamemaker1 |
## Links
- npm: https://www.npmjs.com/package/rate-limit-redis
- Repository: https://github.com/express-rate-limit/rate-limit-redis
- Issues: https://github.com/express-rate-limit/rate-limit-redis/issues
- npm.io page: https://npm.io/package/rate-limit-redis
## Recent versions
- 6.0.1 (latest) — 2026-08-02
- 6.0.0 — 2026-07-17
- 5.0.0 — 2026-05-08
- 4.3.1 — 2025-11-30
- 4.3.0 — 2025-11-19
- 4.2.3 — 2025-10-20
- 4.2.2 — 2025-08-13
- 4.2.1 — 2025-05-30
- 4.2.0 — 2023-11-09
- 4.1.2 — 2023-10-08
- 4.1.1 — 2023-10-05
- 4.1.0 — 2023-10-04
- 4.0.0 — 2023-09-15
- 3.1.0 — 2023-09-01
- 3.0.2 — 2023-05-05
- … 16 more at https://npm.io/package/rate-limit-redis/versions
## README
# `rate-limit-redis`
A [`redis`](https://github.com/redis/redis) store for the
[`express-rate-limit`](https://github.com/nfriedly/express-rate-limit)
middleware. Also supports [`redict`](https://redict.io/) &
[`valkey`](https://valkey.io/).
## Installation
From the npm registry:
```sh
# Using npm
> npm install rate-limit-redis
# Using yarn or pnpm
> yarn/pnpm add rate-limit-redis
```
From Github Releases:
```sh
# Using npm
> npm install https://github.com/express-rate-limit/rate-limit-redis/releases/download/v{version}/rate-limit-redis.tgz
# Using yarn or pnpm
> yarn/pnpm add https://github.com/express-rate-limit/rate-limit-redis/releases/download/v{version}/rate-limit-redis.tgz
```
Replace `{version}` with the version of the package that you want to use, e.g.:
`3.0.0`.
## Usage
### Importing
This library is provided in ESM as well as CJS forms, and works with both
Javascript and Typescript projects.
**This package requires you to use Node 16 or above and Redis 2.6.12 or above.**
Import it in a CommonJS project (`type: commonjs` or no `type` field in
`package.json`) as follows:
```ts
const { RedisStore } = require('rate-limit-redis')
```
Import it in a ESM project (`type: module` in `package.json`) as follows:
```ts
import { RedisStore } from 'rate-limit-redis'
```
### Examples
To use it with a [`node-redis`](https://github.com/redis/node-redis) client:
```ts
import { rateLimit } from 'express-rate-limit'
import { RedisStore } from 'rate-limit-redis'
import { createClient } from 'redis'
// Create a `node-redis` client
const client = createClient({
// ... (see https://github.com/redis/node-redis/blob/master/docs/client-configuration.md)
})
// Then connect to the Redis server
await client.connect()
// Create and use the rate limiter
const limiter = rateLimit({
// Rate limiter configuration
windowMs: 15 * 60 * 1000, // 15 minutes
max: 100, // Limit each IP to 100 requests per `window` (here, per 15 minutes)
standardHeaders: true, // Return rate limit info in the `RateLimit-*` headers
legacyHeaders: false, // Disable the `X-RateLimit-*` headers
// Redis store configuration
store: new RedisStore({
sendCommand: (...args: string[]) => client.sendCommand(args),
}),
})
app.use(limiter)
```
To use it with a [`ioredis`](https://github.com/luin/ioredis) client:
```ts
import { rateLimit } from 'express-rate-limit'
import { RedisStore, type RedisReply } from 'rate-limit-redis'
import RedisClient from 'ioredis'
// Create a `ioredis` client
const client = new RedisClient()
// ... (see https://github.com/luin/ioredis#connect-to-redis)
// Create and use the rate limiter
const limiter = rateLimit({
// Rate limiter configuration
windowMs: 15 * 60 * 1000, // 15 minutes
max: 100, // Limit each IP to 100 requests per `window` (here, per 15 minutes)
standardHeaders: true, // Return rate limit info in the `RateLimit-*` headers
legacyHeaders: false, // Disable the `X-RateLimit-*` headers
// Redis store configuration
store: new RedisStore({
sendCommand: (command: string, ...args: string[]) =>
client.call(command, ...args) as Promise,
}),
})
app.use(limiter)
```
### Configuration
#### `sendCommand`
The function used to send commands to Redis. The function signature is as
follows:
```ts
;(...args: string[]) => Promise | number
```
The raw command sending function varies from library to library; some are given
below:
| Library | Function |
| ------------------------------------------------------------------ | ----------------------------------------------------------------------------- |
| [`node-redis`](https://github.com/redis/node-redis) | `async (...args: string[]) => client.sendCommand(args)` |
| [`node-redis`](https://github.com/redis/node-redis) (cluster) | See `sendCommandCluster` below |
| [`ioredis`](https://github.com/luin/ioredis) | `async (command: string, ...args: string[]) => client.call(command, ...args)` |
| [`handy-redis`](https://github.com/mmkal/handy-redis) | `async (...args: string[]) => client.nodeRedis.sendCommand(args)` |
| [`tedis`](https://github.com/silkjs/tedis) | `async (...args: string[]) => client.command(...args)` |
| [`redis-fast-driver`](https://github.com/h0x91b/redis-fast-driver) | `async (...args: string[]) => client.rawCallAsync(args)` |
| [`yoredis`](https://github.com/djanowski/yoredis) | `async (...args: string[]) => (await client.callMany([args]))[0]` |
| [`noderis`](https://github.com/wallneradam/noderis) | `async (...args: string[]) => client.callRedis(...args)` |
##### `sendCommandCluster`
In cluster mode, node-redis requires a little extra information to help route
the command to the correct server. This is an alternative to `sendCommand` that
provides the necessary extra information. The signature is as follows:
```ts
({key: string, isReadOnly: boolean, command: string[]}) => Promise | number
```
Example usage:
```ts
import { rateLimit } from 'express-rate-limit'
import {
RedisStore,
type RedisReply,
type SendCommandClusterDetails,
} from 'rate-limit-redis'
import { createCluster } from 'redis'
// Create a `node-redis` cluster client
const cluster = new createCluster({
// see https://github.com/redis/node-redis/blob/master/docs/clustering.md
})
// Create and use the rate limiter
const limiter = rateLimit({
// Rate limiter configuration here
// Redis store configuration
store: new RedisStore({
sendCommandCluster: ({
key,
isReadOnly,
command,
}: SendCommandClusterDetails) =>
cluster.sendCommand(key, isReadOnly, command) as Promise,
}),
})
app.use(limiter)
```
#### `prefix`
The text to prepend to the key in Redict/Redis.
Defaults to `rl:`.
## License
MIT © [Wyatt Johnson](https://github.com/wyattjoh),
[Nathan Friedly](https://nfriedly.com),
[Vedant K](https://github.com/gamemaker1)
---
_Source: https://npm.io/package/rate-limit-redis · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
