Quick start¶

Get a microVM running in under a minute.

1. Install¶

curl -sSL https://get.sistemo.io | sh

Or build from source.

2. Start the daemon¶

sudo sistemo up

Info

The daemon needs root for machine networking. It listens on http://localhost:7777.

3. Open the dashboard (optional)¶

Open http://localhost:7777/dashboard/ in your browser. On first visit, create an admin account (username + password). The dashboard lets you deploy and manage machines, images, volumes, and networks from a web UI.

Tip

The CLI works without any login on localhost. The admin account is only needed for the dashboard and remote API access.

4. Deploy a machine¶

In another terminal:

sistemo machine deploy debian
# or: sistemo vm deploy debian
sistemo machine terminal debian

This opens a browser tab with a terminal into the machine. Or SSH directly from your terminal:

sistemo machine ssh debian

5. Expose a port (optional)¶

sistemo machine expose debian --port 80
sistemo machine exec debian "apt-get update && apt-get install -y nginx && systemctl start nginx"
curl http://localhost:80

6. Check your setup (optional)¶

sudo sistemo doctor

Runs 10 diagnostic checks and reports any issues with actionable fixes.

Done¶

You now have a real Linux machine with systemd, package managers, and SSH — running as a Firecracker microVM on your host.

Next steps

Dashboard — Web UI for machines, images, volumes, and terminal
Machines — Deploy, manage, and access machines
Port expose — Forward host ports to machines
Networking — Bridge, machine-to-machine connectivity
Volumes — Persistent block devices
Systemd service — Daemon survives reboots
Configuration — Config file and env vars
Commands — Full CLI reference