Penv documentation

The penv CLI validates and injects environment variables. Penv Cloud is the hosted store it reads them from.

penv is a CLI that validates your environment variables against a committed .env.schema and injects them into one child process. Penv Cloud is our hosted secret store, which penv reads as a provider.

Local mode

penv init                 # reads .env, writes .env.schema and .penv/config.toml, ignores .env and .env.*
penv run -- pnpm dev      # validates, then starts the program with the values

You need no login. See penv init, penv run, local and cloud modes.

Cloud mode

penv login                # device code in the browser
penv push                 # sends your values to us, deletes .env

Your teammate then runs penv run -- pnpm dev in a fresh clone. See penv login, penv push.

Task	Page
What we store and decrypt	What Penv Cloud is
Install the binary	Install the CLI
Adopt an existing `.env`	From a .env file
Use the console	First workspace
Give CI access	Connect your CI
Command reference	CLI reference

Quickstart

Local mode

Cloud mode

Next

On this page