terraform/website/source/docs/commands/env/new.html.md

layout	page_title	sidebar_current	description
commands-env	Command: env new	docs-env-sub-new	The terraform env new command is used to create a new state environment.

Command: env new

The terraform env new command is used to create a new state environment.

Usage

Usage: terraform env new [NAME]

This command will create a new environment with the given name. This environment must not already exist.

If the -state flag is given, the state specified by the given path will be copied to initialize the state for this new environment.

The command-line flags are all optional. The list of available flags are:

• -state=path - Path to a state file to initialize the state of this environment.

Example: Create

$ terraform env new example
Created and switched to environment "example"!

You're now on a new, empty environment. Environments isolate their state,
so if you run "terraform plan" Terraform will not see any existing state
for this configuration.

Example: Create from State

To create a new environment from a pre-existing state path:

$ terraform env new -state=old.terraform.tfstate example
Created and switched to environment "example"!

You're now on a new, empty environment. Environments isolate their state,
so if you run "terraform plan" Terraform will not see any existing state
for this configuration.