stratumctl images

Manage VM images

stratumctl images [flags]

Aliases: image, img

Subcommands

stratumctl images admin-delete: Delete any image install-wide (bootstrap-admin / platform-admin)
stratumctl images admin-get: Describe any image install-wide (bootstrap-admin / platform-admin)
stratumctl images admin-list: List every image install-wide (bootstrap-admin / platform-admin)
stratumctl images create-from-instance: Capture a running instance’s volumes as a project image
stratumctl images create-volume: Boot a new volume from an image
stratumctl images delete: Deregister an owned image (its own snapshots go with it unless –keep-snapshots; refused while a launch template names it unless –force)
stratumctl images deprecate: Deprecate an image now or at a future time (hidden from default lists, launches still allowed)
stratumctl images disable: Disable an image: no new launches, existing instances unaffected
stratumctl images enable: Re-enable a disabled image
stratumctl images export: Export an image to an object in one of the project’s buckets
stratumctl images get: Describe an image
stratumctl images import: URL-import a global or region image (bootstrap-admin)
stratumctl images import-bucket: Import a project image from an object in one of the project’s buckets
stratumctl images list: List images visible to a project (global + region + project-owned + shared + public)
stratumctl images promote: Promote a snapshot to a project-scoped image
stratumctl images publish: Make an owned image visible to every project (public)
stratumctl images share: Share an owned image with other projects
stratumctl images undeprecate: Clear an image’s deprecation
stratumctl images unpublish: Make a public image private again (explicit shares survive)
stratumctl images unshare: Revoke an image share from projects
stratumctl images upload: Upload a qcow2 or raw disk image into the image catalog (bootstrap-admin)

stratumctl images admin-delete

Delete any image install-wide (bootstrap-admin / platform-admin)

stratumctl images admin-delete <image-id> [flags]

Aliases: admin-rm

Examples

stratumctl images admin-delete img-k3m9x2abqt
stratumctl images admin-delete img-k3m9x2abqt --force --keep-snapshots

Flags

Flag	Type	Default	Description
`--force`	bool	`false`	Deregister even while a launch template names the image
`--keep-snapshots`	bool	`false`	Leave behind the snapshots a create-from-instance took for this image (they pin the source volume)

stratumctl images admin-get

Describe any image install-wide (bootstrap-admin / platform-admin)

stratumctl images admin-get <image-id> [flags]

Examples

stratumctl images admin-get img-k3m9x2abqt
stratumctl images admin-get img-k3m9x2abqt --output json

stratumctl images admin-list

List every image install-wide (bootstrap-admin / platform-admin)

stratumctl images admin-list [flags]

Examples

stratumctl images admin-list
stratumctl images admin-list --scope project --output json

Flags

Flag	Type	Default	Description
`--region`	string		Filter region-scoped images by region
`--scope`	string		Filter by scope (global \| region \| project)

stratumctl images create-from-instance

Capture a running instance’s volumes as a project image

stratumctl images create-from-instance [flags]

Examples

stratumctl images create-from-instance --instance i-uy3ureaklq --name web-golden
stratumctl images create-from-instance --instance i-uy3ureaklq --name web-golden --no-reboot --tag env=prod

Flags

Flag	Type	Default	Description
`--description`	string		Free-text description
`--display-name`	string		Human-friendly display name
`--instance`	string		Source instance ID (required)
`--name`	string		New image name (required)
`--no-reboot`	bool	`false`	Snapshot without stopping the instance: the instance agent freezes the filesystems (consistency quiesced); with no agent answering, crash-consistent
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)
`--tag`	stringArray		Tag as key=value (repeatable)

stratumctl images create-volume

Boot a new volume from an image

stratumctl images create-volume <image-id> [flags]

Examples

stratumctl images create-volume img-k3m9x2abqt --name boot-01
stratumctl images create-volume img-k3m9x2abqt --name boot-02 --size-gib 40

Flags

Flag	Type	Default	Description
`--display-name`	string		Human-friendly display name
`--name`	string		New volume name (required)
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)
`--size-gib`	int64	`0`	Volume size override in GiB (defaults to image size)
`--storage-class`	string		Storage class override (defaults to image’s class)

stratumctl images delete

Deregister an owned image (its own snapshots go with it unless –keep-snapshots; refused while a launch template names it unless –force)

stratumctl images delete <image-id> [flags]

Aliases: deregister

Examples

stratumctl images delete img-k3m9x2abqt
stratumctl images delete img-k3m9x2abqt --keep-snapshots

Flags

Flag	Type	Default	Description
`--force`	bool	`false`	Deregister even while a launch template’s $Default/$Latest names the image
`--keep-snapshots`	bool	`false`	Leave behind the snapshots a create-from-instance took for this image. They pin the source volume, so keeping them blocks that volume’s delete
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl images deprecate

Deprecate an image now or at a future time (hidden from default lists, launches still allowed)

stratumctl images deprecate <image-id> [flags]

Examples

stratumctl images deprecate img-k3m9x2abqt
stratumctl images deprecate img-k3m9x2abqt --at 2027-01-01T00:00:00Z

Flags

Flag	Type	Default	Description
`--at`	string		Deprecate at this RFC3339 time instead of now
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl images disable

Disable an image: no new launches, existing instances unaffected

stratumctl images disable <image-id> [flags]

Examples

stratumctl images disable img-k3m9x2abqt

Flags

Flag	Type	Default	Description
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl images enable

Re-enable a disabled image

stratumctl images enable <image-id> [flags]

Examples

stratumctl images enable img-k3m9x2abqt

Flags

Flag	Type	Default	Description
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl images export

Export an image to an object in one of the project’s buckets

stratumctl images export <image-id> [flags]

Examples

stratumctl images export img-k3m9x2abqt --bucket bkt-6k2m8x4q7a --key exports/web-golden.qcow2
stratumctl images export img-k3m9x2abqt --bucket bkt-6k2m8x4q7a --key exports/web-golden.raw --format raw

Flags

Flag	Type	Description
`--bucket`	string	Destination bucket ID (required)
`--format`	string	Export format: qcow2 \| raw (defaults to qcow2)
`--key`	string	Destination object key (required)
`--project`	string	Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl images get

Describe an image

stratumctl images get <image-id> [flags]

Examples

stratumctl images get img-k3m9x2abqt
stratumctl images get img-k3m9x2abqt --output json

Flags

Flag	Type	Default	Description
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl images import

URL-import a global or region image (bootstrap-admin)

stratumctl images import [flags]

Examples

stratumctl images import --name almalinux-10 --url https://repo.almalinux.org/almalinux/10/cloud/x86_64/images/AlmaLinux-10-GenericCloud-latest.x86_64.qcow2 \
  --format qcow2 --os-family linux --os-distro almalinux --os-version 10

Flags

Flag	Type	Default	Description
`--arch`	string	`amd64`	Image architecture (amd64 \| arm64)
`--display-name`	string		Human-friendly display name
`--format`	string	`raw`	Source format (raw \| qcow2)
`--name`	string		Image name (required)
`--os-distro`	string		OS distribution
`--os-family`	string		OS family
`--os-version`	string		OS version
`--region`	string		Region (required when scope is `region`)
`--scope`	string	`global`	Visibility scope (global \| region)
`--sha256`	string		Expected hex-encoded SHA256 of the source bytes
`--size-gib`	int64	`0`	Virtual disk size in GiB (optional; auto-derived from the image on import)
`--storage-class`	string		Storage class for the imported image (default: the install’s default class)
`--url`	string		Source URL (required)

stratumctl images import-bucket

Import a project image from an object in one of the project’s buckets

stratumctl images import-bucket [flags]

Examples

stratumctl images import-bucket --name custom-01 --bucket bkt-6k2m8x4q7a --key images/custom-01.qcow2 --storage-class replicated

Flags

Flag	Type	Default	Description
`--arch`	string	`amd64`	Image architecture (amd64 \| arm64)
`--bucket`	string		Source bucket ID (required)
`--description`	string		Free-text description
`--display-name`	string		Human-friendly display name
`--format`	string		Disk format: qcow2 \| raw (sniffed when omitted)
`--key`	string		Source object key (required)
`--name`	string		New image name (required)
`--os-distro`	string		OS distribution (e.g. ubuntu)
`--os-family`	string		OS family (e.g. linux)
`--os-version`	string		OS version (e.g. 24.04)
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)
`--sha256`	string		Expected SHA-256 of the object (hex); the import fails on mismatch
`--storage-class`	string		Storage class for the image (required)
`--tag`	stringArray		Tag as key=value (repeatable)

stratumctl images list

List images visible to a project (global + region + project-owned + shared + public)

stratumctl images list [flags]

Examples

stratumctl images list
stratumctl images list --owner self --include-deprecated
stratumctl images list --scope global --output json

Flags

Flag	Type	Default	Description
`--include-deprecated`	bool	`false`	Include deprecated images (hidden by default)
`--owner`	string		Filter by owner: self \| shared \| public \| system
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)
`--scope`	string		Filter to one scope: global \| region \| project

stratumctl images promote

Promote a snapshot to a project-scoped image

stratumctl images promote [flags]

Examples

stratumctl images promote --from-snapshot snap-4k8m2x7q9a --name web-golden --os-family linux --os-distro ubuntu --os-version 24.04

Flags

Flag	Type	Default	Description
`--arch`	string	`amd64`	Image architecture (amd64 \| arm64)
`--display-name`	string		Human-friendly display name
`--from-snapshot`	string		Source snapshot ID (required)
`--name`	string		New image name (required)
`--os-distro`	string		OS distribution (e.g. ubuntu)
`--os-family`	string		OS family (e.g. linux)
`--os-version`	string		OS version (e.g. 24.04)
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl images publish

Make an owned image visible to every project (public)

stratumctl images publish <image-id> [flags]

Examples

stratumctl images publish img-k3m9x2abqt

Flags

Flag	Type	Default	Description
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

Share an owned image with other projects

stratumctl images share <image-id> [flags]

Examples

stratumctl images share img-k3m9x2abqt --with p-team-b
stratumctl images share img-k3m9x2abqt --with p-team-b,p-team-c

Flags

Flag	Type	Default	Description
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)
`--with`	stringSlice		Project ID(s) to share with (required, comma-separated or repeated)

stratumctl images undeprecate

Clear an image’s deprecation

stratumctl images undeprecate <image-id> [flags]

Examples

stratumctl images undeprecate img-k3m9x2abqt

Flags

Flag	Type	Default	Description
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl images unpublish

Make a public image private again (explicit shares survive)

stratumctl images unpublish <image-id> [flags]

Examples

stratumctl images unpublish img-k3m9x2abqt

Flags

Flag	Type	Default	Description
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl images unshare

Revoke an image share from projects

stratumctl images unshare <image-id> [flags]

Examples

stratumctl images unshare img-k3m9x2abqt --from p-team-b

Flags

Flag	Type	Default	Description
`--from`	stringSlice		Project ID(s) to revoke from (required, comma-separated or repeated)
`--project`	string		Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl images upload

Upload a qcow2 or raw disk image into the image catalog (bootstrap-admin)

stratumctl images upload [flags]

Streams the file to the control plane, which checks it (sha256 when given, qemu-img: qcow2 or raw, no backing file) and imports it into the storage class (default: the default class). The image is pending until the import finishes; stratumctl images admin-get <id> follows it.

Examples

stratumctl images upload --file./debian-13-genericcloud-amd64.qcow2 --name debian-13 \
  --os-family linux --os-distro debian --os-version 13

Flags

Flag	Type	Description
`--arch`	string	Image architecture (amd64 \| arm64; default amd64)
`--description`	string	Description
`--display-name`	string	Human-friendly display name
`--file`	string	The disk image to upload (qcow2 or raw; required)
`--format`	string	qcow2 \| raw (default: read from the file)
`--name`	string	Image name (required)
`--os-distro`	string	OS distribution
`--os-family`	string	OS family
`--os-version`	string	OS version
`--region`	string	Region (required when scope is `region`)
`--scope`	string	global \| region (default global)
`--sha256`	string	Expected hex sha256 of the file; a mismatch refuses the upload
`--storage-class`	string	Storage class to import into (default: the default class)