VMs
A VM is a full Linux virtual machine with its own kernel and its own persistent disk. You create it with new, and it keeps running until you stop or delete it.
Names and addresses
Section titled “Names and addresses”Every VM has a name, unique within your account. The name gives you two addresses:
| What | Address |
|---|---|
| SSH | ssh <vm>@turm.dev |
| HTTPS | https://<vm>.turm.dev (port 80 in the VM by default) |
If you don’t pass --name, new picks one for you. ls shows it.
The default image is agentuntu. It includes the pi coding agent, already set up for the LLM gateway, and the agentcloud-addon tool for optional add-ons. Pick another image with new --image=<name>.
Lifecycle
Section titled “Lifecycle”| Command | Effect |
|---|---|
new |
Create and boot a VM. |
stop <vm> |
Shut it down. The disk stays. |
start <vm> |
Boot it again. |
restart <vm> |
Stop, then start. |
cp <vm> <new> |
Copy the VM, disk included, under a new name. |
resize <vm> --cpu=N --memory=M |
Change its CPU and memory. |
rm <vm> |
Delete the VM and its disk. This cannot be undone. |
Users inside the VM
Section titled “Users inside the VM”SSH sessions land as root. Setup scripts run as the default user agentcloud, whose home is /home/agentcloud.