Skip to main content

Documentation Index

Fetch the complete documentation index at: https://upstash.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Need a Redis database fast? Skip the signup and dashboard — POST to https://upstash.com/start-redis to get an endpoint and token in a single HTTP request. 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

  1. Grab your Redis credentials from the Upstash dashboard
  2. Paste them into your Next environment variables:
    .env
    UPSTASH_REDIS_REST_URL=https://holy-kite-17499.upstash.io
UPSTASH_REDIS_REST_TOKEN=AURbAAIncDEyYjM4M...
  3. 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.

​
3. 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.