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

Subcommands


list

List available images, optionally filtered by organization and region.
nscale images list [flags]

Flags

FlagDescription
—org stringOrganization ID
—region stringRegion ID
—jsonEmit the full JSON payload (mutually exclusive with -q)
-q, —query stringArrayjq filter for value extraction (see Query output with -q)

Example

nscale images list --org <org-id> --region <region-id>

create

Create a new custom image. Accepts input from a JSON file or stdin.
nscale images create [flags]

Flags

FlagDescription
—org stringOrganization ID
—region stringRegion ID
-f, —file stringPath to a JSON file
—stdinRead JSON from standard input
—dry-runPreview the request payload without persisting
-y, —yesAutomatically confirm creation
—jsonEmit the full JSON payload (mutually exclusive with -q)
-q, —query stringArrayjq filter for value extraction (see Query output with -q)

Examples

nscale images create --file image.json
nscale images create --stdin < image.json
cat image.json | nscale images create --stdin

delete

Delete an existing image.
nscale images delete --id <image-id> [flags]

Flags

FlagDescription
--id stringImage ID
--org stringOrganization ID
--region stringRegion ID
--dry-runPreview the request payload without persisting
-y, --yesAutomatically confirm deletion

Example

nscale images delete --id <image-id> --org <org-id> --yes

Custom Images (Console)

Upload and use custom OS images via the Console UI.