Skip to main content

1. Install and authenticate

Follow Installation, then check your connection:

2. Start a computer

Start an Ubuntu computer with a workload that stays running. --detach returns its ID so you can use it in later commands:
Startup continues in the background. Check the state and wait for running before continuing:

3. Run a command

Run a command inside that computer. Arguments after -- go to the command:

4. Write and read a file

5. Clean up

Delete the computer when you’re done:
If deletion is still pending, follow the retry command printed by the CLI.

Next steps

CLI reference

See every supported command and option.

Import local images

Run an image from Docker, OrbStack, or Podman.