targon vm

Deploy and manage confidential VMs.

VMs are workloads: inspect them with targon workload. SSH keys are fixed at creation — pass --ssh-key to vm deploy; they cannot be attached or detached after the VM boots.

targon vm <COMMAND>

Shared spec options

These flags apply to deploy and create:

Flag	Description
--name <NAME>	VM name
--image <IMAGE>	Image from the catalog (see targon vm images)
--resource <SKU>	Inventory SKU (see targon inventory --type vm)
--ssh-key UID	SSH key to attach (repeatable; fixed at creation)
--port PORT	Exposed port (repeatable, comma-separated)
--project <UID>	Project to assign (default: active project from project use)
--password-stdin	Read the VM password from stdin (for CI)

When required flags are omitted in an interactive terminal, the CLI prompts for name, image (from catalog picker), resource, SSH keys, and password.

targon vm deploy

Create and start a VM from the image catalog.

targon vm deploy [OPTIONS] [-y]

targon vm deploy \
  --name my-vm \
  --image ubuntu \
  --resource h200-small \
  --ssh-key shk-abc123

targon vm create

Register a VM without starting it.

targon vm create [OPTIONS] [-y]

After creation, start with targon vm start <UID>.

targon vm start

Start a registered VM.

targon vm start <UID>

targon vm reboot

Reboot a running VM.

targon vm reboot <UID>

targon vm list

List VMs.

targon vm list [OPTIONS]

Flag	Description
--status <STATUS>	Filter by lifecycle status (alias: --state)
--project <UID>	Filter by project
--name <NAME>	Filter by name
--limit <N>	Max results (default: 50)
--cursor <CURSOR>	Pagination cursor

targon vm images

List available VM images from the catalog.

targon vm images

Use an image name value with --image when deploying.