> ## Documentation index
> Fetch the complete documentation index at: https://upstash.com/docs/llms.txt
> Ask it with GET https://upstash.com/docs/ask?q=<keywords or question>. Short keywords rank best.
> Use these to discover all available pages before exploring further.
> Feature requests: https://upstash.com/docs/common/help/feature-requests.md lists what users asked for and how to vote for a request or add one.
> Page rating: `GET https://upstash.com/docs/feedback?path=/docs/redis/quickstarts/express&helpful={true|false}&comment={comment}` records whether this page helped. The `comment` (URL-encoded, at most 500 characters) says what helped, or what was missing or wrong; a `helpful=false` rating needs it. It is anonymous and needs no key. Comments hold no code, secrets or personal data.

# Upstash Redis with Express (Node.js)

> Add a Redis cache to an Express app with ioredis, run it locally, then deploy it to any host (Render, Railway, Fly.io, DigitalOcean, a VPS or Docker) by setting REDIS_URL.

An Express server connects to Upstash Redis with a standard Redis client. The
server reads one connection string from `REDIS_URL`, so the same code runs on
any host where you set that variable.

This quickstart adds a cache-aside route: it reads from Redis first, and on a
miss it loads the data, stores it with a TTL (time to live, after which Redis
deletes the key) and returns it.

<Note>
  On serverless and edge runtimes, use
  [`@upstash/redis`](/redis/howto/connect-with-upstash-redis) instead.
</Note>

### Database Setup

Create a Redis database using the [Upstash Console](https://console.upstash.com)
or [Upstash CLI](https://github.com/upstash/cli). Open the database page, go to
the **Connect** section and select the **TCP** tab. Copy the connection string.
It looks like this:

```text
rediss://default:YOUR_TOKEN@YOUR_ENDPOINT:6379
```

See [Connect Your Client](/redis/howto/connect-client) for what each part means.

### Project Setup

Create a project and install Express and ioredis:

```shell
mkdir express-upstash && cd express-upstash
npm init -y
npm install express ioredis
npm pkg set scripts.start="node index.js"
```

### The Code

Create `index.js`:

```javascript index.js
const express = require("express");
const { Redis } = require("ioredis");

const app = express();
const redis = new Redis(process.env.REDIS_URL);

// Stand-in for a slow database or third-party API
async function getProductFromDb(id) {
  await new Promise((resolve) => setTimeout(resolve, 500));
  return { id, name: `Product ${id}`, price: 19.99 };
}

app.get("/products/:id", async (req, res) => {
  const key = `product:${req.params.id}`;

  const cached = await redis.get(key);
  if (cached) {
    return res.json({ source: "cache", data: JSON.parse(cached) });
  }

  const product = await getProductFromDb(req.params.id);
  await redis.set(key, JSON.stringify(product), "EX", 60);
  res.json({ source: "database", data: product });
});

const port = process.env.PORT || 3000;
app.listen(port, () => {
  console.log(`Server running on port ${port}`);
});
```

The route caches each product for 60 seconds. When the data changes, delete the
key (`await redis.del(key)`) so the next request loads the new value.

### Run Locally

Put the connection string in a `.env` file and start the server. Node.js 20.6
and later can load the file with `--env-file`:

```shell .env
REDIS_URL="rediss://default:YOUR_TOKEN@YOUR_ENDPOINT:6379"
```

```shell
node --env-file=.env index.js
```

Request the same product twice. The first request loads it from the
"database", the second one comes from Redis:

```shell
curl http://localhost:3000/products/42
# {"source":"database","data":{"id":"42","name":"Product 42","price":19.99}}

curl http://localhost:3000/products/42
# {"source":"cache","data":{"id":"42","name":"Product 42","price":19.99}}
```

Add `.env` to your `.gitignore` so the token is not committed.

### Deploy

The app only needs two things from a host: a way to run `npm start` and an
environment variable named `REDIS_URL` with your connection string. Hosts set
`PORT` themselves, and the code above already reads it.

<CardGroup cols={2}>
  <Card title="Render" icon="server" href="/redis/quickstarts/render">
    Deploy as a Render Web Service.
  </Card>
  <Card title="Fly.io" icon="paper-plane" href="/redis/quickstarts/fly">
    Deploy with `fly launch`.
  </Card>
  <Card title="DigitalOcean" icon="droplet" href="/redis/quickstarts/digitalocean">
    Deploy on App Platform or a Droplet.
  </Card>
  <Card title="Koyeb" icon="cloud" href="/redis/quickstarts/koyeb">
    Deploy from Git or a container.
  </Card>
</CardGroup>

On a VPS or with Docker, pass the variable when you start the process, for
example `docker run -e REDIS_URL="rediss://..." my-app`.

For sessions, see [Express Session with Upstash Redis](/redis/tutorials/express_session).
