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.

GitHub Repository

You can find the project source code on GitHub.

​
Project Setup

Let’s create a new Next.js application with App Router and install @upstash/redis package. 
npx create-next-app@latest
cd my-app
npm install @upstash/redis

​
Database Setup

Create a Redis database using Upstash Console or Upstash CLI and copy the UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN into your .env file.
.env
UPSTASH_REDIS_REST_URL=<YOUR_URL>
UPSTASH_REDIS_REST_TOKEN=<YOUR_TOKEN>

​
Function Setup

This is a Vercel Serverless Function. If you want to use Edge Runtime, you can add the export const runtime = 'edge' line to this Route Handler.
Create /app/api/hello/route.ts:
/app/api/hello/route.ts
import { Redis } from "@upstash/redis";
import { NextResponse } from "next/server";

const redis = Redis.fromEnv();

export async function GET() {
    const count = await redis.incr("counter");
    return NextResponse.json({ count });
}

export const dynamic = 'force-dynamic'

​
Run & Deploy

Run the app locally with npm run dev, check http://localhost:3000/api/hello Deploy your app with vercel
You can also integrate your Vercel projects with Upstash using Vercel Integration module. Check this article.