Skip to content

ironflow env

Manage environments.

Terminal window
ironflow env <subcommand> [flags]

Environments provide logical isolation within a single Ironflow instance. All data (functions, events, runs, streams, projections) is scoped to the environment that created it. API keys are managed separately via ironflow apikey — see API Keys.

Ironflow creates one default environment on first boot:

NameID
defaultenv_default

List all environments with their IDs.

Terminal window
ironflow env list [--server URL]

Create a new environment.

Terminal window
ironflow env create <name> [--server URL] [--project PROJECT_ID]
FlagTypeDefaultDescription
--projectstringProject ID to associate with the environment

Creates an isolated namespace within your Ironflow instance. The new environment starts empty — no functions, events, or runs.

Delete an environment by ID.

Terminal window
ironflow env delete <id> [--server URL]

Deletes the environment. The default environment (env_default) cannot be deleted.

All env subcommands accept --server / -s to override the server URL.

Examples:

Terminal window
# List environments
ironflow env list
# Create a new environment for a specific app
ironflow env create my-app
# Delete a custom environment
ironflow env delete env_my-app