env - Runpod Documentation

Manage deployment environments for Flash applications. Environments are isolated deployment contexts (like dev, staging, production) within a Flash app.

Command

flash env <subcommand> [OPTIONS]

Subcommands

Subcommand	Description
`list`	Show all environments for an app
`create`	Create a new environment
`get`	Show details of an environment
`delete`	Delete an environment and its resources

env list

Show all available environments for an app.

Command

flash env list [OPTIONS]

Example

# List environments for current app
flash env list

# List environments for specific app
flash env list --app APP_NAME

Flags

--app, -a

string

Flash app name. Auto-detected from current directory if not specified.

Output

┏━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
┃ Name       ┃ ID                  ┃ Active Build      ┃ Created At       ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━┩
│ dev        │ env_abc123          │ build_xyz789      │ 2024-01-15 10:30 │
│ staging    │ env_def456          │ build_uvw456      │ 2024-01-16 14:20 │
│ production │ env_ghi789          │ build_rst123      │ 2024-01-20 09:15 │
└────────────┴─────────────────────┴───────────────────┴──────────────────┘

env create

Create a new deployment environment.

Command

flash env create <NAME> [OPTIONS]

Example

# Create staging environment
flash env create staging

# Create environment in specific app
flash env create production --app APP_NAME

Arguments

NAME

string

required

Name for the new environment (e.g., dev, staging, production).

Flags

--app, -a

string

Flash app name. Auto-detected from current directory if not specified.

Notes

If the app doesn’t exist, it’s created automatically.
Environment names must be unique within an app.
Newly created environments have no active build until first deployment.

You don’t always need to create environments explicitly. Running flash deploy --env <name> creates the environment automatically if it doesn’t exist.

env get

Show detailed information about a deployment environment.

Command

flash env get <NAME> [OPTIONS]

Example

# Get details for production environment
flash env get production

# Get details for specific app's environment
flash env get staging --app APP_NAME

Arguments

NAME

string

required

Name of the environment to inspect.

Flags

--app, -a

string

Flash app name. Auto-detected from current directory if not specified.

Output

╭────────────────────────────────────╮
│ Environment: production            │
├────────────────────────────────────┤
│ ID: env_ghi789                     │
│ State: DEPLOYED                    │
│ Active Build: build_rst123         │
│ Created: 2024-01-20 09:15:00       │
╰────────────────────────────────────╯

           Associated Endpoints
┏━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┓
┃ Name           ┃ ID                 ┃
┡━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━┩
│ my-gpu         │ ep_abc123          │
│ my-cpu         │ ep_def456          │
└────────────────┴────────────────────┘

       Associated Network Volumes
┏━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┓
┃ Name           ┃ ID                 ┃
┡━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━┩
│ model-cache    │ nv_xyz789          │
└────────────────┴────────────────────┘

env delete

Delete a deployment environment and all its associated resources.

Command

flash env delete <NAME> [OPTIONS]

Examples

# Delete development environment
flash env delete dev

# Delete environment in specific app
flash env delete staging --app APP_NAME

Arguments

NAME

string

required

Name of the environment to delete.

Flags

--app, -a

string

Flash app name. Auto-detected from current directory if not specified.

Process

Shows environment details and resources to be deleted.
Prompts for confirmation (required).
Undeploys all associated endpoints.
Removes all associated network volumes.
Deletes the environment from the app.

This operation is irreversible. All endpoints, volumes, and configuration associated with the environment will be permanently deleted.

Environment states

State	Description
PENDING	Environment created but not deployed
DEPLOYING	Deployment in progress
DEPLOYED	Successfully deployed and running
FAILED	Deployment or health check failed
DELETING	Deletion in progress

Common workflows

Three-tier deployment

# Create environments
flash env create dev
flash env create staging
flash env create production

# Deploy to each
flash deploy --env dev
flash deploy --env staging
flash deploy --env production

Feature branch testing

# Create feature environment
flash env create FEATURE_NAME

# Deploy feature branch
git checkout FEATURE_NAME
flash deploy --env FEATURE_NAME

# Clean up after merge
flash env delete FEATURE_NAME

flash deploy - Deploy to an environment
flash app - Manage applications
flash undeploy - Remove specific endpoints

​Subcommands

​env list

​Example

​Flags

​Output

​env create

​Example

​Arguments

​Flags

​Notes

​env get

​Example

​Arguments

​Flags

​Output

​env delete

​Examples

​Arguments

​Flags

​Process

​Environment states

​Common workflows

​Three-tier deployment

​Feature branch testing

​Related commands

Subcommands

env list

Example

Flags

Output

env create

Example

Arguments

Flags

Notes

env get

Example

Arguments

Flags

Output

env delete

Examples

Arguments

Flags

Process

Environment states

Common workflows

Three-tier deployment

Feature branch testing

Related commands