Machines

new

Create a VM.

machine0 new <vm> [flags]

Flag	Description	Default
`-s, --size`	VM size — see pricing or run `machine0 sizes`	`small`
`-r, --region`	`us-east`, `us-west`, `uk`, `eu`, `asia`	`eu`
`-i, --image`	Image slug	`ubuntu-24-04-loaded`
`-k, --key`	SSH key name	Default key
`-e, --env`	Env set name to inject as environment variables
`--mount`	Mount a disk (experimental): `disk:<name> path:</abs/path>`, repeatable

machine0 new my-vm
machine0 new my-vm --size large --region us-east
machine0 new my-gpu --size gpu-h100-1
machine0 new my-vm --env production
machine0 new my-vm --mount disk:data path:/data

ls

List all VMs.

machine0 ls
machine0 ls --json

get

Show VM details: specs, pricing, IP, SSH key, timestamps.

machine0 get <vm>

start

Start a stopped or suspended VM. Suspended VMs are recreated from their snapshot with the same name, size, region, and key. Requires sufficient wallet balance.

machine0 start <vm>

stop

Stop a running VM.

machine0 stop <vm>

Stopped VMs still incur charges. Suspend or destroy to stop billing.

reboot

machine0 reboot <vm>

suspend

Snapshot the VM, delete the cloud instance, pay only image storage.

machine0 suspend <vm> [flags]

Flag	Description
`-y, --yes`	Skip confirmation

The VM moves to SUSPENDED. Start again with machine0 start. Destroying a suspended VM also deletes its snapshot.

rm

Destroy a VM.

machine0 rm [vm] [flags]

Flag	Description
`-a, --all`	Destroy all VMs
`-y, --yes`	Skip confirmation

ssh

SSH into a VM or run a remote command.

machine0 ssh <vm> [command...]

Flag	Description	Default
`--username`	SSH username	`ubuntu`

machine0 ssh my-vm
machine0 ssh my-vm "docker ps"
machine0 ssh my-vm --username nix

If the VM is still starting, the CLI waits for SSH. If the VM has disk mounts that are still coming up, the CLI briefly waits for those too before opening the session. Commands run under the remote user’s default non-login shell. For login-shell initialization, wrap with: machine0 ssh my-vm bash -lc 'your-command'.

update

Update a VM’s name, default SSH username, or SSH client initial command.

machine0 update <vm> [flags]

Flag	Description
`-n, --name`	New name (updates `mac0.io` endpoint)
`--default-ssh-username`	Default SSH username
`--ssh-client-initial-command`	Command run automatically when the VM is opened in the iPhone app’s SSH client (pass `""` to clear)
`-y, --yes`	Skip confirmation

machine0 update my-vm --ssh-client-initial-command "tmux attach || tmux new"
machine0 update my-vm --ssh-client-initial-command ""   # clear

The SSH client initial command runs once per session, right after the shell loads — only in the iPhone app’s terminal (requires app 1.2.2 or later; the web terminal and machine0 ssh don’t run it). It shows in machine0 get under the SSH key. When you create an image from the VM, the command is copied onto the snapshot, and VMs created from that snapshot inherit it (override any time with machine0 update). Snapshots taken before the command was set are not retroactively updated. The command is stored and displayed in plain text — don’t embed secrets in it; use env sets for secrets.

provision

Provision a VM with a Nix flake or Ansible playbook.

machine0 provision <vm> <source> [flags]

Flag	Description	Default
`--username`	SSH username	auto
`--dry-run`	Print planned actions without executing

<source> can be a local directory, flake.nix path, remote flake ref, or .yml playbook. Append #profile to pick a specific NixOS configuration.

machine0 provision my-vm setup.yml
machine0 provision my-vm ./flake.nix#minimal
machine0 provision my-vm github:owner/repo#default

See Provisioning for details.

sizes

Show available VM sizes and pricing.

machine0 sizes [flags]

Flag	Description
`-a, --all`	Include out-of-stock sizes

Introduction

Examples

Platform

Reference

new

ls

get

start

stop

reboot

suspend

rm

ssh

update

provision

sizes

​new

​ls

​get

​start

​stop

​reboot

​suspend

​rm

​ssh

​update

​provision

​sizes

new

ls

get

start

stop

reboot

suspend

rm

ssh

update

provision

sizes