Skip to main content
Images are the base templates used when creating compute instances. You can use public images or create custom ones. Aliases: images, img Commands that act on one image take its ID or name either as a positional argument or with --id. If you omit it, the CLI opens an interactive picker, so always pass it in scripts.

​
Subcommands

​
list

List available images, optionally filtered by organization and region.
Aliases: list, ls

​
Flags

FlagDescription
Organization ID or name
Region ID or name
Show at most N results (client-side; every result is still fetched). Cuts before -q. 0 for all
Emit the full JSON payload (mutually exclusive with -q)
jq filter for value extraction (see Query output with -q)

​
Example

​
create

Create a new custom image. Accepts input from a JSON file or stdin; with neither, the CLI prompts for the image details.

​
Flags

FlagDescription
Organization ID or name
Region ID or name
Path to a JSON file
Read JSON from standard input
Preview actions and payload without persisting
Automatically confirm creation
Emit the full JSON payload (mutually exclusive with -q)
jq filter for value extraction (see Query output with -q)

​
Examples

​
delete

Delete an existing image.
Aliases: delete, rm, remove

​
Flags

​
Example

Custom Images (Console)

Upload and use custom OS images via the Console UI.