Everything, written down
1VMTool is a Mac app and a command line that are both clients of the same core, so anything you can click is something you can script. These pages cover both, and state the limits where there are limits.
Getting started
Installation
What 1VMTool needs, how to install it, and why the app has to be signed a particular way.
Your first machine
Creating, starting and reaching a virtual machine, from the app and from the command line.
Snapshots and rollback
Why a snapshot costs almost nothing here, how the tree branches, and the three different ways to get back to a known-good state.
Guests
Linux guests
ARM64 Linux on either engine, shared folders, clipboard, and what Rosetta can and cannot do for you.
macOS guests
Running macOS inside macOS — what Apple allows, what it does not, and why this is the one thing most alternatives cannot do.
Windows on ARM
Windows 11 ARM on the first-party engine — what ships, what it needs from you, and why it is still labelled experimental.
Reference
The 1vm command line
Full command reference. Every action in the app has a command, because both front ends are clients of the same core.
Settings reference
Every dotted key you can read with `1vm get` and change with `1vm set`.
Networking
The three network modes, port forwarding, and which one needs an entitlement from Apple.
SSH
Reaching a guest over SSH from the Mac — which address actually works, the one line added to your ssh config, keys, accounts and host-key trust.
The VM bundle
A machine is a folder. What is inside it, what is safe to copy, and what to commit.
Docker
The managed Docker engine, the workspace for what runs inside it, and how both stay out of the way of the Docker you already have.
Automation and JSON
The frozen `--json` contract, exit codes, disposable task machines, and the MCP server.
Engines and limits
Which engine runs which guest, and the ceiling on each — stated up front rather than discovered later.
Help
Two pages that live outside the docs
The 1VM engine explains the first-party hypervisor in depth — why it replaced QEMU and which capability tier it is honestly at. Omarchy on a Mac is a full walkthrough of the bundled Arch and Hyprland desktop.