Display user’s current instances
Usage
vastai show instances [OPTIONS] [--api-key API_KEY] [--raw]
Options
only display numeric ids (alias: --quiet)
Description
Returns a list of instance objects. Key status fields per instance:
actual_status — current container state:
| Value | Meaning |
|---|
null | Instance is being provisioned |
loading | Docker image is downloading or container is starting up |
running | Container is actively executing. GPU charges apply. |
stopped | Container is halted. Disk charges continue; no GPU charges. |
frozen | Container is paused with memory preserved. GPU charges apply. |
exited | Container process exited unexpectedly |
rebooting | Container is restarting (transient) |
unknown | No recent heartbeat from the host |
offline | Host machine disconnected from Vast servers (computed, not stored in DB) |
running, stopped, or frozen.
cur_state — machine contract / hardware allocation state: running, stopped, or unloaded (released on destroy).
status_msg — human-readable detail on the current status.
Examples
Global Options
The following options are available for all commands:
| Option | Description |
|---|
--url URL | Server REST API URL |
--retry N | Retry limit |
--raw | Output machine-readable JSON |
--explain | Verbose explanation of API calls |
--api-key KEY | API key (defaults to ~/.config/vastai/vast_api_key) |
