upstash-redis

Upstash Redis

Overview

@upstash/redis is a Redis client that talks to an Upstash Redis database over HTTPS instead of a TCP connection. Because every command is a stateless HTTP request, it works in environments where a pooled TCP client is awkward or impossible: Vercel and Netlify functions, Cloudflare Workers, Deno, Bun, and Next.js middleware. The client serializes and deserializes JavaScript values automatically, so numbers and objects round-trip without manual JSON.parse.

When to Use This Skill

• Use when the user needs a cache, session store, counter, leaderboard, or

simple queue from a serverless or edge function.

• Use when the user mentions Upstash Redis, UPSTASH_REDIS_REST_URL, or

@upstash/redis.

• Use when migrating an ioredis or node-redis call site to a runtime that

cannot hold a persistent TCP socket.

• Do not use for a self-hosted or non-Upstash Redis server; the client only

speaks the Upstash REST protocol. Use ioredis or node-redis there.

• Do not use for Redis administration or CLI work; see redis-cli.

How It Works

Step 1: Configure credentials

Create a database in the Upstash console and copy the REST URL and token into environment variables. Never hardcode them.

UPSTASH_REDIS_REST_URL=https://<your-db>.upstash.io
UPSTASH_REDIS_REST_TOKEN=<your-rest-token>

Step 2: Create one client per module