App Router - 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.

Quickstart: Upstash Redis in Next 15

1. Install package

In your Next.js app, install our @upstash/redis package:

npm install @upstash/redis

2. Connect to Redis

Grab your Redis credentials from the Upstash dashboard

Paste them into your Next environment variables:

.env

UPSTASH_REDIS_REST_URL=https://holy-kite-17499.upstash.io
UPSTASH_REDIS_REST_TOKEN=AURbAAIncDEyYjM4M...

Create a Redis instance, for example in lib/redis.ts

lib/redis.ts

import { Redis } from "@upstash/redis"

// 👇 we can now import our redis client anywhere we need it
export const redis = new Redis({
  url: process.env.UPSTASH_REDIS_REST_URL,
  token: process.env.UPSTASH_REDIS_REST_TOKEN,
})

3. Using our Redis Client

We can now connect to Upstash Redis from any server component or API route. For example:

app/page.tsx

import { redis } from "@/lib/redis"

// 👇 server component
const Page = async () => {
  const count = await redis.get<number>("count")
  return <p>count: {count}</p>
}

export default Page

Because this count doesn’t exist yet, let’s create a Next API route to populate it.

4. Storing data in Redis

Let’s create a super simple API that, every time when called, increments an integer value we call count. This is the same value we display in our page above:

app/api/counter/route.ts

import { redis } from "@/lib/redis"

export const POST = async () => {
  await redis.incr("count")

  return new Response("OK")
}

Perfect! Every time we now call this API, we increment the count in our Redis database:

The server component fetches the most recent count at render-time and displays the up-to-date value automatically. For a video demo, check the video at the top of this article.

Examples

GitHub Repository

You can find the project source code on GitHub.

If you’re already on Vercel, you can create Upstash projects directly through Vercel: Read more.

​Quickstart: Upstash Redis in Next 15

​1. Install package

​2. Connect to Redis

​3. Using our Redis Client

​4. Storing data in Redis

​Examples

GitHub Repository

Quickstart: Upstash Redis in Next 15

1. Install package

2. Connect to Redis

3. Using our Redis Client

4. Storing data in Redis

Examples