Virtual machines
Create a Linux VM, connect over SSH or in your browser, and manage its lifecycle.
A virtual machine (VM) runs a Linux operating system where you can install packages and run your own software. It joins the private network of the environment you create it in. Virtual machines are in beta.
Create and boot a VM
- Open your project canvas and select an environment. Fund your workspace wallet to use the browser console.
- Press
Cmd + Kon macOS orCtrl + Kon Windows and Linux, then choose Virtual Machine. - Select an Image and set the Boot Disk size. Server images support 10–200 GB. Ubuntu 24.04 Desktop supports 20–200 GB and requires at least 4 GB of memory.
- Under SSH Public Keys, paste one public key per line. Server images require 1–10 keys. Keys are optional on the desktop image unless you plan to connect over SSH. Keep the matching private key on your device.
- Click Create. Open the new VM on the canvas, then click Deployments → Create VM to boot it. Wait for the status to show Running.
| Image | SSH username |
|---|---|
| Ubuntu 22.04 LTS | ubuntu |
| Ubuntu 24.04 LTS | ubuntu |
| Debian 12 | debian |
| Rocky Linux 9 | rocky |
| Ubuntu 24.04 Desktop | ubuntu |
Open the browser console
In the running deployment, click Open console, then select Console. This opens a shell on the VM without exposing SSH to the internet. If you chose Ubuntu 24.04 Desktop, select Desktop to view the screen and Take control to use the mouse and keyboard. See Computers for AI Agents for desktop automation.
Connect over SSH
From the private network
Open the VM’s Settings → Connection and copy the SSH Command. Run it from a client that can reach the environment’s private network and has the matching private key. The VM’s private hostname is not reachable from your laptop over the public internet.
From the internet
- Open the VM’s Settings → Networking → TCP Proxy and enter
22as the internal port. - Under Allowed source IPs, enter the public IPs or CIDR ranges you want to allow, one per line. For one IPv4 address, use a range like
203.0.113.9/32. Leaving the field empty allows connections from any IP. - Click Add TCP Proxy, then Apply in the canvas’s Apply Changes bar.
- Once the proxy is ready, copy its public host and assigned port from Settings → Networking. Connect using that port. Replace
31544,ssh.example.com, and the private key path in this example with your own values. Use the SSH username for your image.
ssh -i ~/.ssh/simplifyd_vm -p 31544 ubuntu@ssh.example.comIf SSH times out, check that the VM is running, the proxy shows a public endpoint, and the allowlist includes your current public IP. If SSH returns Permission denied (publickey), check the username and that your private key matches one of the public keys you added. See TCP and UDP endpoints for more about public ports.
Stop, start, or delete a VM
- Stop: In Deployments, click Stop, then Stop VM to confirm. The VM shuts down and keeps its boot disk. vCPU and memory charges pause; boot disk charges continue.
- Start: In Deployments, click Start. The VM boots from the same disk, with its files and installed software intact.
- Delete: In Settings → Danger, click Delete Service and confirm. This permanently removes the VM and its boot disk. Back up any files you need first.
To automate creation and lifecycle actions, use the virtual machines API.