- CLI Reference
- Commands
- ironflow env
ironflow env
Manage environments.
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:
| Name | ID |
|---|---|
| default | env_default |
ironflow env list
Section titled “ironflow env list”List all environments with their IDs.
ironflow env list [--server URL]ironflow env create
Section titled “ironflow env create”Create a new environment.
ironflow env create <name> [--server URL] [--project PROJECT_ID]| Flag | Type | Default | Description |
|---|---|---|---|
--project | string | Project ID to associate with the environment |
Creates an isolated namespace within your Ironflow instance. The new environment starts empty — no functions, events, or runs.
ironflow env delete
Section titled “ironflow env delete”Delete an environment by ID.
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:
# List environmentsironflow env list
# Create a new environment for a specific appironflow env create my-app
# Delete a custom environmentironflow env delete env_my-app