setup

Configure your Upstash Redis credentials to connect Redenv to your database.

The setup command configures your global Upstash Redis credentials. This is the first command you should run after installing Redenv.

Usage#

redenv setup

What It Does#

Prompts for your Upstash Redis URL (e.g., https://your-db.upstash.io)
Prompts for your Upstash Redis Token (masked input)
Prompts for your email (used for audit trails)
Saves credentials to the global config file

Interactive Flow#

$ redenv setup

? Enter your Upstash Redis URL: https://my-redis.upstash.io
? Enter your Upstash Redis Token: ********
? Please enter your email for auditing purposes: dev@example.com

✔ Global config saved successfully!

Credential Storage#

Credentials are stored in your system's config directory:

OS	Location
Linux	`~/.config/redenv/config.json`
macOS	`~/Library/Application Support/redenv/config.json`
Windows	`%APPDATA%\redenv\config.json`

Info

These credentials are used to connect to Upstash Redis. They are not your Master Password.

Multiple Databases#

If you've previously configured credentials, setup will show your saved connections and let you choose:

$ redenv setup

? Select Upstash credentials:
❯ https://prod-db.upstash.io | ****xyz1 | 1/15/2026, 10:00:00 AM
  https://dev-db.upstash.io | ****abc2 | 1/10/2026, 3:30:00 PM
  ✨ Use new credentials

Getting Your Credentials#

Go to Upstash Console
Create or select a Redis database
Copy the REST URL and REST Token from the database details