Skip to main content
Usage: fal environments [-h] [--debug] [--pdb] [--cprofile] command ...

Manage fal environments.

Options:
  -h, --help  show this help message and exit

Commands:
  command
    list      List environments.
    create    Create an environment.
    delete    Delete an environment.
The environments command also has an alias envs for convenience:
fal envs list

​
List

Usage: fal environments list [-h] [--debug] [--pdb] [--cprofile]
                             [--output {pretty,json}] [--json]

List environments.

Options:
  -h, --help            show this help message and exit

Output:
  --output {pretty,json}
                        Modify the command output
  --json                Output in JSON format (same as --output json)

Examples:
  fal environments list
  fal envs list --output json

​
Create

Usage: fal environments create [-h] [--debug] [--pdb] [--cprofile]
                               [--description DESCRIPTION]
                               name

Create an environment.

Positional Arguments:
  name                  Environment name.

Options:
  -h, --help            show this help message and exit
  --description DESCRIPTION
                        Environment description.

Examples:
  fal environments create staging
  fal envs create dev --description "Development environment"

​
Delete

Usage: fal environments delete [-h] [--debug] [--pdb] [--cprofile] [--yes]
                               name

Delete an environment.

Positional Arguments:
  name        Environment name.

Options:
  -h, --help  show this help message and exit
  --yes       Skip confirmation prompt.

Debug:
  --debug     Show verbose errors.
  --pdb       Start pdb on error.
  --cprofile  Show cProfile report.
Deleting an environment permanently removes all apps and secrets in that environment. You will be prompted to confirm by typing the environment name unless --yes is provided.

​
Using Environments with Other Commands

Once you’ve created environments, you can target them using the --env flag in other commands: 
# Deploy to an environment
fal deploy path/to/myapp.py::MyApp --env staging

# Manage secrets per environment
fal secrets set API_KEY=value --env staging
fal secrets list --env staging

# Manage apps per environment
fal apps list --env staging
fal apps scale my-app --min-concurrency 1 --env staging
fal apps runners my-app --env staging
fal apps delete my-app --env staging

# Run functions with environment-specific secrets
fal run path/to/myapp.py::MyApp --env staging