a free, serverless redis clone backed by cloudflare durable objects. drop-in replacement for upstash redis.

• upstash compatible api (works w upstash sdks)
• redis over http(s) / http compatible key-value store
• pipelining support
• free storage backed by cloudflare durable objects
• low memory footprint <3 lambda go runtime

SET options: NX, XX, GET, EX, PX, EXAT, PXAT, KEEPTTL

EXPIRE / EXPIREAT options: NX, XX, GT, LT

LPOP / RPOP options: count

• a compute layer exposes a POST endpoint
• accepts upstash redis commands in the request body
• translates the command into sqlite queries
• forwards the queries to the storage layer, a durable object instance
• durable object executes the queries against its sqlite database and returns the result
• compute layer returns the result to the client

set AUTH_TOKEN to a random secret string when prompted — generate one at jwtsecretkeygenerator.com

tip: for lower latency, set a location hint in meowdis/src/index.ts before deploying to pin the durable object to a region close to your users:

const stub = env.STORAGE.get(id, { locationHint: "apac" });

then initialise the database:

curl https://meowdis.example.workers.dev \
  -H "Authorization: Bearer your-token" \
  -d '["INIT"]'

verify it's working:

curl https://meowdis.example.workers.dev \
  -H "Authorization: Bearer your-token" \
  -d '["PING"]'                       # {"result":"PONG"}

python

from upstash_redis import Redis

redis = Redis(url="https://meowdis.example.workers.dev", token="your-token")

redis.ping()                          # 'PONG'
redis.set("name", "clairo")           # 'OK'
redis.get("name")                     # 'clairo'

node

import { Redis } from "@upstash/redis";

const redis = new Redis({
  url: "https://meowdis.example.workers.dev",
  token: "your-token",
});

await redis.ping(); // 'PONG'
await redis.set("name", "clairo"); // 'OK'
await redis.get("name"); // 'clairo'

rest (see upstash rest api docs)

curl https://meowdis.example.workers.dev \
  -H "Authorization: Bearer your-token" \
  -d '["PING"]'                       # {"result":"PONG"}

curl https://meowdis.example.workers.dev \
  -H "Authorization: Bearer your-token" \
  -d '["SET", "name", "clairo"]'      # {"result":"OK"}

curl https://meowdis.example.workers.dev \
  -H "Authorization: Bearer your-token" \
  -d '["GET", "name"]'                # {"result":"clairo"}

1. deploy the storage layer

2. deploy the compute layer

option a — cloudflare worker (compute-node)

option b — aws lambda (compute-go)

3. initialise the database

curl https://your-compute-endpoint \
  -H "Authorization: Bearer your-token" \
  -d '["INIT"]'

4. verify it's working

curl https://your-compute-endpoint \
  -H "Authorization: Bearer your-token" \
  -d '["PING"]'                       # {"result":"PONG"}