1ctl machine

1ctl machine manages user-owned machine inventory and machine diagnostics, and lists monetized machines available for rent.

Commands

1ctl machine list
1ctl machine get <machine-id|name|numeric-id>
1ctl machine create --name <name> --region <region> --zone <zone> --cpu <cores> --memory <gb> --storage <gb>
1ctl machine update <machine-id|name|numeric-id> [flags]
1ctl machine delete <machine-id|name|numeric-id> --yes
1ctl machine inspect <machine-id|name|numeric-id> [--refresh]
1ctl machine logs <machine-id|name|numeric-id> [--source <source>] [--tail <n>] [--since <duration>] [--filter <text>]
1ctl machine events <machine-id|name|numeric-id> [--tail <n>]
1ctl machine available [filters]
1ctl machine usage list
1ctl machine usage get --usage-id <id>
1ctl machine usage cost --usage-id <id>

Machine references resolve against machines owned by the authenticated user, so name-based updates and deletes do not target another user’s machine.

Inventory fields

machine create and machine update support:

Field	Flag
Name	`--name`
Machine type	`--type` repeatable; default `worker`
Region / zone	`--region`, `--zone`
IP address	`--ip`
Talos / Kubernetes version	`--talos-version`, `--kubernetes-version`
CPU / memory / storage	`--cpu`, `--memory`, `--storage`
GPU	`--gpu-count`, `--gpu-type`
Bandwidth	`--bandwidth`
Hardware metadata	`--brand`, `--model`, `--manufacturer`, `--form-factor`
Rentable capacity	`--monetized`, `--recommended`, `--pricing-tier`
Organization scope	`--organization-id`

delete decommissions the machine through the authenticated machine API.

Inspect, logs, and events

machine inspect combines the machine inventory record, hardware details, SatuSky node labels, and Talos status. Use --refresh to refresh hardware data before printing.

Log filters:

Flag	Purpose
`--source`	Repeatable source filter: `siderolink`, `talos`, or `kubernetes`.
`--component`	Repeatable component filter.
`--tail` / `-n`	Number of lines. Default `100`.
`--since`	Duration or timestamp, such as `10m` or `1h`.
`--filter`	Text filter.
`--previous`	Include previous container logs when available.

Available machines

1ctl machine available --region MY --zone my-kul-1b --min-cpu 4 --min-memory 8 --recommended

Filters:

Flag	Purpose
`--region`	Region filter.
`--zone`	Zone filter.
`--min-cpu`	Minimum CPU cores.
`--min-memory`	Minimum memory in GB.
`--gpu`	Only machines with GPU.
`--recommended`	Only recommended machines.
`--pricing-tier`	Pricing tier filter.

Quotas

Tier quotas apply when deploying to rented monetized machines not owned by the user. BYOA deployments to owned verified machines are not tier-limited.

Tier	Credits	CPU	Memory	Pods	PVCs	Services
Free	0-99	2 cores	4Gi	10	5	5
Starter	100-499	4 cores	8Gi	25	10	10
Pro	500-1999	8 cores	16Gi	50	20	25
Enterprise	2000+	16 cores	32Gi	100	50	50