Skip to main content
Manage Flash applications. An app is the top-level container that groups your deployment environments, build artifacts, and configuration.
Command
flash app <subcommand> [OPTIONS]

​
Subcommands

SubcommandDescription
listShow all apps in your account
createCreate a new app
getShow details of an app
deleteDelete an app and all its resources

​
app list

Show all Flash apps under your account.
Command
flash app list

​
Output

┏━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
┃ Name           ┃ ID                   ┃ Environments            ┃ Builds           ┃
┡━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━┩
│ my-project     │ app_abc123           │ dev, staging, prod      │ build_1, build_2 │
│ demo-api       │ app_def456           │ production              │ build_3          │
│ ml-inference   │ app_ghi789           │ dev, production         │ build_4, build_5 │
└────────────────┴──────────────────────┴─────────────────────────┴──────────────────┘

​
app create

Register a new Flash app on Runpod’s backend.
Command
flash app create <NAME>

​
Arguments

​
NAME
string
required
Name for the new Flash app. Must be unique within your account.

​
What it creates

This command registers a Flash app in Runpod’s backend—essentially creating a namespace for your environments and builds. It does not:
  • Create local files (use flash init for that).
  • Provision cloud resources (endpoints, volumes, etc.).
  • Deploy any code.
The app is just a container that groups environments and builds together.

​
When to use

Most users don’t need to run flash app create explicitly. Apps are created automatically when you first run flash deploy. This command is primarily for CI/CD pipelines that need to pre-register apps before deployment.

​
app get

Get detailed information about a Flash app.
Command
flash app get <NAME>

​
Arguments

​
NAME
string
required
Name of the Flash app to inspect.

​
Output

╭─────────────────────────────────╮
│ Flash App: my-project           │
├─────────────────────────────────┤
│ Name: my-project                │
│ ID: app_abc123                  │
│ Environments: 3                 │
│ Builds: 5                       │
╰─────────────────────────────────╯

              Environments
┏━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
┃ Name       ┃ ID                 ┃ State   ┃ Active Build     ┃ Created          ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━┩
│ dev        │ env_dev123         │ DEPLOYED│ build_xyz789     │ 2024-01-15 10:30 │
│ staging    │ env_stg456         │ DEPLOYED│ build_xyz789     │ 2024-01-16 14:20 │
│ production │ env_prd789         │ DEPLOYED│ build_abc123     │ 2024-01-20 09:15 │
└────────────┴────────────────────┴─────────┴──────────────────┴──────────────────┘

                     Builds
┏━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
┃ ID                 ┃ Status                   ┃ Created          ┃
┡━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━┩
│ build_abc123       │ COMPLETED                │ 2024-01-20 09:00 │
│ build_xyz789       │ COMPLETED                │ 2024-01-18 15:45 │
│ build_def456       │ COMPLETED                │ 2024-01-15 11:20 │
└────────────────────┴──────────────────────────┴──────────────────┘

​
app delete

Delete a Flash app and all its associated resources.
Command
flash app delete <NAME>

​
Arguments

​
NAME
string
required
Name of the Flash app to delete.

​
Process

  1. Shows app details and resources to be deleted.
  2. Prompts for confirmation (required).
  3. Deletes all environments and their resources.
  4. Deletes all builds.
  5. Deletes the app.
This operation is irreversible. All environments, builds, endpoints, volumes, and configuration will be permanently deleted.

​
App hierarchy

See Apps and environments for the complete app organization structure.

​
Auto-detection

Flash CLI automatically detects the app name from your current directory: 
cd /path/to/APP_NAME
flash deploy          # Deploys to 'APP_NAME' app
flash env list        # Lists 'APP_NAME' environments
Override with the --app flag: 
flash deploy --app other-project
flash env list --app other-project