ov env

An environment (env) is a named slot inside an app where secrets actually live. A typical app has a production, staging, and dev env, each with its own copy of the same secret names. Switching env switches which copy ov run and ov secret commands resolve to.

A new app starts with zero environments. You add the first one with ov env create (or with --with-env on ov app create). Secrets cannot be stored until at least one env exists.

---

Commands

Command	Description
ov env create <slug>	Create a new environment in the active app
ov env list	List environments for the active app
ov env use <slug>	Set the default environment for all secret commands
ov env delete <slug>	Delete an environment and all its secrets

---

ov env create

ov env create production
ov env create staging --name "Staging (EU)"

Creates a new environment in the active app. Slugs follow the same rules as app slugs — 1–63 characters, lowercase letters and digits, hyphens allowed in the middle.

Flags

Flag	Description
--app <slug>	App slug (overrides the default set by ov app use)
--name <string>	Display name for the environment (defaults to the slug)

---

ov env list

ov env list

Lists all environments in the active app, with the default env (set by ov env use) marked *:

SLUG        NAME              CREATED                ACTIVE
production  Production        2026-04-01T12:00:00Z   *
staging     Staging (EU)      2026-04-02T09:30:00Z
dev         dev               2026-04-02T09:31:00Z

Flags

Flag	Description
--app <slug>	App slug (overrides the default set by ov app use)

---

ov env use

ov env use staging

Sets staging as the default environment for all subsequent ov secret and ov run commands. Stored in ~/.config/ov/config.toml. Override per-command with --env.

Flags

Flag	Description
--app <slug>	App slug (overrides the default set by ov app use)

---

ov env delete

ov env delete dev --force

Permanently deletes the environment and all secrets in it. This cannot be undone. Requires --force.

Flags

Flag	Description
--app <slug>	App slug (overrides the default set by ov app use)
--force	Force deletion of the environment and all its secrets

---

Related

• ov app — the top-level container for environments
• ov secret — store and manage secrets in an app/env
• ov status — show your current app, env, and resolution source
• ov run — run commands with secrets injected