---
title: pulumi env | CLI commands
url: /docs/iac/cli/commands/pulumi_env/
---

Manage environments

## Synopsis

Manage environments

An environment is a named collection of possibly-secret, possibly-dynamic data.
Each environment has a definition and may be opened in order to access its contents.
Opening an environment may involve generating new dynamic data.

To begin working with environments, run the `env init` command:

env init

This will prompt you to create a new environment to hold secrets and configuration.

For more information, please visit the project page: https://www.pulumi.com/docs/esc

## Options

```
      --env string   The name of the environment to operate on.
  -h, --help         help for env
```

## Options inherited from parent commands

```
      --color string                 Colorize output. Choices are: always, never, raw, auto (default "auto")
  -C, --cwd string                   Run pulumi as if it had been started in another directory
      --disable-integrity-checking   Disable integrity checking of checkpoint files
  -e, --emoji                        Enable emojis in the output
  -Q, --fully-qualify-stack-names    Show fully-qualified stack names
      --logflow                      Flow log settings to child processes (like plugins)
      --logtostderr                  Log to stderr instead of to files
      --memprofilerate int           Enable more precise (and expensive) memory allocation profiles by setting runtime.MemProfileRate
      --non-interactive              Disable interactive mode for all commands
      --otel-traces string           Export OpenTelemetry traces to the specified endpoint. Use file:// for local JSON files, grpc:// for remote collectors
      --profiling string             Emit CPU and memory profiles and an execution trace to '[filename].[pid].{cpu,mem,trace}', respectively
      --tracing file:                Emit tracing to the specified endpoint. Use the file: scheme to write tracing data to a local file
  -v, --verbose int                  Enable verbose logging (e.g., v=3); anything >3 is very verbose
```

## SEE ALSO

* [pulumi](/docs/iac/cli/commands/pulumi/)	 - Pulumi command line
* [pulumi env clone](/docs/iac/cli/commands/pulumi_env_clone/)	 - Clone an existing environment into a new environment.
* [pulumi env diff](/docs/iac/cli/commands/pulumi_env_diff/)	 - Show changes between versions.
* [pulumi env edit](/docs/iac/cli/commands/pulumi_env_edit/)	 - Edit an environment definition
* [pulumi env get](/docs/iac/cli/commands/pulumi_env_get/)	 - Get a value within an environment.
* [pulumi env init](/docs/iac/cli/commands/pulumi_env_init/)	 - Create an empty environment with the given name.
* [pulumi env ls](/docs/iac/cli/commands/pulumi_env_ls/)	 - List environments.
* [pulumi env open](/docs/iac/cli/commands/pulumi_env_open/)	 - Open the environment with the given name.
* [pulumi env open-request](/docs/iac/cli/commands/pulumi_env_open-request/)	 - Create a request for opening a protected environment.
* [pulumi env provider](/docs/iac/cli/commands/pulumi_env_provider/)	 - Manage login providers within an environment
* [pulumi env referrer](/docs/iac/cli/commands/pulumi_env_referrer/)	 - Manage environment referrers
* [pulumi env rm](/docs/iac/cli/commands/pulumi_env_rm/)	 - Remove an environment or a value from an environment.
* [pulumi env rotate](/docs/iac/cli/commands/pulumi_env_rotate/)	 - Rotate secrets in an environment
* [pulumi env run](/docs/iac/cli/commands/pulumi_env_run/)	 - Open the environment with the given name and run a command.
* [pulumi env schedule](/docs/iac/cli/commands/pulumi_env_schedule/)	 - Manage environment scheduled actions
* [pulumi env set](/docs/iac/cli/commands/pulumi_env_set/)	 - Set a value within an environment.
* [pulumi env settings](/docs/iac/cli/commands/pulumi_env_settings/)	 - Manage environment settings
* [pulumi env tag](/docs/iac/cli/commands/pulumi_env_tag/)	 - Manage environment tags
* [pulumi env version](/docs/iac/cli/commands/pulumi_env_version/)	 - Manage versions
* [pulumi env webhook](/docs/iac/cli/commands/pulumi_env_webhook/)	 - Manage environment webhooks