Cloudflare Workers - Upstash Documentation

If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.

Database Setup

Create a Redis database using Upstash Console or Upstash CLI.

Project Setup

We will use C3 (create-cloudflare-cli) command-line tool to create our application. You can open a new terminal window and run C3 using the prompt below.

npm create cloudflare@latest -- upstash-redis-worker

yarn create cloudflare upstash-redis-worker

pnpm create cloudflare upstash-redis-worker

This will create a new Cloudflare Workers project:

➜  npm create cloudflare@latest -- upstash-redis-worker

> npx
> create-cloudflare upstash-redis-worker


─────────────────────────────────────────────────────────────────────────────────────────────────
👋 Welcome to create-cloudflare v2.50.8!
🧡 Let's get started.
📊 Cloudflare collects telemetry about your usage of Create-Cloudflare.

Learn more at: https://github.com/cloudflare/workers-sdk/blob/main/packages/create-cloudflare/telemetry.md
─────────────────────────────────────────────────────────────────────────────────────────────────

╭ Create an application with Cloudflare Step 1 of 3
│
├ In which directory do you want to create your application?
│ dir ./upstash-redis-worker
│
├ What would you like to start with?
│ category Hello World example
│
├ Which template would you like to use?
│ type Worker only
│
├ Which language do you want to use?
│ lang TypeScript
│
├ Copying template files
│ files copied to project directory
│
├ Updating name in `package.json`
│ updated `package.json`
│
├ Installing dependencies
│ installed via `npm install`
│
╰ Application created 

...

────────────────────────────────────────────────────────────
🎉  SUCCESS  Application created successfully!

We will also install the Upstash Redis SDK to connect to Redis.

npm install @upstash/redis

The Code

Here is a Worker template to configure and test Upstash Redis connection.

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

export interface Env {
  UPSTASH_REDIS_REST_URL: string;
  UPSTASH_REDIS_REST_TOKEN: string;
}

export default {
	async fetch(request, env, ctx): Promise<Response> {
		const redis = Redis.fromEnv(env);
		const count = await redis.incr("counter");
		return new Response(JSON.stringify({ count }));
		
	},
} satisfies ExportedHandler<Env>;

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

export default {
  async fetch(request, env, ctx) {
    const redis = Redis.fromEnv(env);
    const count = await redis.incr("counter");
    return new Response(JSON.stringify({ count }));
  },
};

Configure Credentials

There are two methods for setting up the credentials for Redis. One for worker level, the other for account level.

Using Cloudflare Secrets (Worker Level Secrets)

This is the common way of creating secrets for your worker, see Workflow Secrets

Navigate to Upstash Console and get your Redis credentials.
In Cloudflare Dashboard, Go to Compute (Workers) > Workers & Pages.
Select your worker and go to Settings > Variables and Secrets.
Add your Redis credentials as secrets here:

Using Cloudflare Secrets Store (Account Level Secrets)

This method requires a few modifications in the worker code, see Access to Secret on Env Object

src/index.ts

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

export interface Env {
  UPSTASH_REDIS_REST_URL: SecretsStoreSecret;
  UPSTASH_REDIS_REST_TOKEN: SecretsStoreSecret;
}

export default {
	async fetch(request, env, ctx): Promise<Response> {
		const redis = Redis.fromEnv({
			UPSTASH_REDIS_REST_URL: await env.UPSTASH_REDIS_REST_URL.get(),
			UPSTASH_REDIS_REST_TOKEN: await env.UPSTASH_REDIS_REST_TOKEN.get(),
		});
		const count = await redis.incr("counter");
		return new Response(JSON.stringify({ count }));

	},
} satisfies ExportedHandler<Env>;

After doing these modifications, you can deploy the worker to Cloudflare with npx wrangler deploy, and follow the steps below to define the secrets:

Navigate to Upstash Console and get your Redis credentials.
In Cloudflare Dashboard, Go to Secrets Store and add Redis credentials as secrets.

Under Compute (Workers) > Workers & Pages, find your worker and add these secrets as bindings.

Deployment

Newer deployments may revert the configurations you did in the dashboard. While worker level secrets persist, the bindings will be gone!

Deploy your function to Cloudflare with npx wrangler deploy The endpoint of the function will be provided to you, once the deployment is done.

Testing

Open a different terminal and test the endpoint. Note the destination url is the same that was printed in the previous deploy step.

curl -X POST 'https://<your-worker-name>.<account-name>.workers.dev' \
     -H 'Content-Type: application/json' 

The response will be in the format of {"count":20} In the logs you should see something like this:

$ npx wrangler tail

⛅️ wrangler 4.43.0
--------------------

Successfully created tail, expires at 2025-10-16T18:59:18Z
Connected to <your-worker-name>, waiting for logs...
POST https://<your-worker-name>.<account-name>.workers.dev/ - Ok @ 10/16/2025, 4:05:30 PM

Repositories

Javascript: https://github.com/upstash/upstash-redis/tree/main/examples/cloudflare-workers Typescript: https://github.com/upstash/upstash-redis/tree/main/examples/cloudflare-workers-with-typescript

​Database Setup

​Project Setup

​The Code

​Configure Credentials

​Using Cloudflare Secrets (Worker Level Secrets)

​Using Cloudflare Secrets Store (Account Level Secrets)

​Deployment

​Testing

​Repositories

Database Setup

Project Setup

The Code

Configure Credentials

Using Cloudflare Secrets (Worker Level Secrets)

Using Cloudflare Secrets Store (Account Level Secrets)

Deployment

Testing

Repositories