Skip to main content
This guide uses no local project files or implicit target. Each operation names the remote computer it affects.

​
1. Install and authenticate

Follow Installation, then verify both the binary and your API key:

​
2. Start a computer

Public OCI references are resolved by Vers. Detached mode writes the new computer UUID to stdout; progress and recovery information go to stderr.
Use vers list to see all of your computers or vers get for one detailed record:

​
3. Run a foreground workload

The -- delimiter separates Vers arguments from the image’s workload command:
Foreground run passes workload stdout to local stdout, workload stderr to local stderr, and returns the workload exit status. --rm asks Vers to remove the workload computer durably after it exits.

​
4. Write and read a file

write reads stdin when --content is omitted, up to 16 MiB:

​
5. Clean up

Deletion requires --yes at parse time:
If the admitted deletion remains pending, the CLI prints its durable operation ID and the exact retry command.

​
Next steps

CLI reference

See every supported command and option.

Import local images

Run an image from Docker, OrbStack, or Podman.