redenv/Docs

Installation

Install the Redenv CLI to start managing encrypted secrets from your terminal.

Edit this page

CLI#

Install the Redenv CLI globally using your preferred package manager:

bun add -g @redenv/cli
npm install -g @redenv/cli
pnpm add -g @redenv/cli
yarn global add @redenv/cli

Verify the installation:

redenv --version

Info

Requires Node.js 16+ and an Upstash Redis instance (free tier works).

Runtime SDKs#

SDKs let your application fetch secrets at runtime. Install the one for your language:

bun install @redenv/client
bun install -D @redenv/core
pip install redenv

The @redenv/core dev dependency is required for config files and plugins. SDKs are optional — the CLI works standalone for injecting secrets via redenv run. See the JavaScript SDK or Python SDK docs for usage.

Troubleshooting#

Keychain access errors#

On first run, Redenv stores your Upstash credentials in the system keychain.

  • macOS — Grant keychain access when prompted
  • Linux — Install gnome-keyring or libsecret
  • Windows (WSL) — May need manual credential storage