---
title: "esc env"
menu:
  esc_cli:
    parent: commands
---



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/pulumi-cloud/esc

## Options

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

## SEE ALSO

* [esc](/docs/esc-cli/commands/esc/)	 - Pulumi ESC command line
* [esc env edit](/docs/esc-cli/commands/esc_env_edit/)	 - Edit an environment definition
* [esc env get](/docs/esc-cli/commands/esc_env_get/)	 - Get a value within an environment.
* [esc env init](/docs/esc-cli/commands/esc_env_init/)	 - Create an empty environment with the given name.
* [esc env ls](/docs/esc-cli/commands/esc_env_ls/)	 - List environments.
* [esc env open](/docs/esc-cli/commands/esc_open/)	 - Open the environment with the given name.
* [esc env rm](/docs/esc-cli/commands/esc_env_rm/)	 - Remove an environment or a value from an environment.
* [esc env run](/docs/esc-cli/commands/esc_run/)	 - Open the environment with the given name and run a command.
* [esc env set](/docs/esc-cli/commands/esc_env_set/)	 - Set a value within an environment.

###### Auto generated by spf13/cobra on 9-Oct-2023