targon workload
Manage workloads. Alias: wl.
The CLI currently registers and deploys RENTAL workloads. Use the dashboard or Workloads API to create VM workloads; you can then list, inspect, reboot, and fetch logs for VMs with the commands below.
targon workload <COMMAND>
Shared deploy options
These flags apply to deploy and create:
| Flag | Description |
|---|---|
--name <NAME> | Workload name |
--image <IMAGE> | Container image |
--resource <SKU> | Inventory SKU (e.g. h200-small) |
--env KEY=VAL | Environment variable (repeatable) |
--port PORT[/PROTO[/ROUTING]] | Exposed port; protocol TCP, UDP, or SCTP; routing PROXIED or DIRECT |
--volume UID:/path[:ro] | Volume mount (repeatable) |
--ssh-key UID | SSH key to attach (repeatable) |
--command <CMD> | Container command (repeatable) |
--arg <ARG> | Container argument (repeatable) |
--project <UID> | Project to assign |
--registry-server <URL> | Private registry server |
--registry-user <USER> | Registry username |
--registry-pass <PASS> | Registry password |
When required flags are omitted in an interactive terminal, the CLI prompts for them and can show an inventory picker for --resource.
targon workload deploy
Register and start a workload, or deploy an existing one by UID.
targon workload deploy [UID] [OPTIONS]
| Flag | Description |
|---|---|
--no-start | Register without starting |
-y, --yes | Skip confirmation prompt |
Without a UID, the command registers a new workload from the spec flags and deploys it. With a UID, it deploys an existing registered workload.
targon workload deploy \
--name my-job \
--image pytorch/pytorch:latest \
--resource h200-small \
--port 8080/TCP/PROXIED \
--port 2222/TCP/DIRECT
targon workload create
Register a workload without starting it.
targon workload create [OPTIONS]
Accepts the same spec flags as deploy. Use -y to skip the confirmation prompt.
targon workload list
List workloads.
targon workload list [OPTIONS]
| Flag | Description |
|---|---|
--status <STATUS> | Filter by lifecycle status |
--project <UID> | Filter by project |
--name <NAME> | Filter by name |
--limit <N> | Max results (default: 50) |
targon workload get
Show details for a workload, including state, URLs, volumes, and SSH keys.
targon workload get <UID>
targon workload delete
Delete a workload.
targon workload delete <UID> [-y]
targon workload logs
Read logs from a workload.
targon workload logs <UID> [OPTIONS]
| Flag | Description |
|---|---|
--since <TIME> | Only logs after this timestamp |
--tail <N> | Number of recent lines |
--previous | Logs from the previous container instance |
-f, --follow | Stream logs until interrupted |
targon workload events
Show recent events for a workload.
targon workload events <UID> [--limit <N>]
Default limit is 20.
targon workload exec
Run a command inside a running workload.
targon workload exec <UID> -- <COMMAND> [ARGS...]
targon workload attach-volume
Attach a volume to a workload.
targon workload attach-volume <UID> <VOLUME_UID> --mount-path <PATH> [--read-only]
targon workload detach-volume
Detach a volume from a workload.
targon workload detach-volume <UID> <VOLUME_UID>
targon workload attach-ssh-key
Attach an SSH key to a workload.
targon workload attach-ssh-key <UID> <SSH_KEY_UID>
targon workload detach-ssh-key
Detach an SSH key from a workload.
targon workload detach-ssh-key <UID> <SSH_KEY_UID>
targon workload suspend
Suspend a running workload.
targon workload suspend <UID>
targon workload reboot
Reboot a workload. Supported for VM workloads.
targon workload reboot <UID>
Virtual Machines
VM workloads are created through the dashboard or the Workloads API with type: "VM" and vm_config.password. After a VM is registered and deployed, use the CLI to manage it:
# List and inspect
targon workload list
targon workload get <UID>
# Reboot a running VM
targon workload reboot <UID>
# Fetch serial or QEMU logs (API supports ?type=serial|qemu)
targon workload logs <UID> --tail 100
See the Virtual Machines guide for image selection, SSH access, and port configuration.