ioredis-serverlessRedis client for serverless environments

A fork of ioredis using WebSockets instead of TCP

WebSocket Transport

Uses WebSocket instead of TCP, enabling Redis access from environments that don't support raw TCP connections.

Serverless Compatible

Works in Cloudflare Workers, Vercel Edge Functions, Bunny Edge Scripting, and other edge/serverless runtimes.

100% ioredis API

Drop-in replacement for ioredis. Same API, same behavior — just a different transport layer. Refer to the official ioredis docs for usage.

Overview

ioredis-serverless is a fork of ioredis, the popular Redis client for Node.js. It replaces the TCP transport layer with WebSockets to enable Redis connectivity in serverless and edge environments.

Why WebSockets?

Most serverless platforms (Cloudflare Workers, Vercel Edge, etc.) do not allow raw TCP connections. They do, however, support WebSocket connections. ioredis-serverless bridges this gap by communicating with Redis over WebSockets.

WebSocket Proxy Requirement

Since Redis itself speaks TCP, a WebSocket-to-TCP proxy is required between the client and Redis server. The proxy translates WebSocket frames to Redis protocol and vice versa.

┌─────────────────┐     WebSocket     ┌─────────────┐     TCP      ┌─────────┐
│  Edge Function  │ ───────────────── │   WS Proxy  │ ──────────── │  Redis  │
└─────────────────┘                   └─────────────┘              └─────────┘