Documentation

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.

入门

安装

1VMTool 需要什么、如何安装，以及应用为何必须按特定方式签名。

你的第一台机器

从应用和命令行创建、启动并访问虚拟机。

快照与回滚

为何在此快照几乎不花成本、树如何分支，以及回到已知良好状态的三种方式。

来宾

Linux guest

ARM64 Linux 可在任一引擎上运行，共享文件夹、剪贴板，以及 Rosetta 能做什么、不能做什么。

macOS guest

在 macOS 内运行 macOS——Apple 允许什么、不允许什么，以及这是多数替代方案做不到的能力。

ARM 版 Windows

first-party 引擎上的 Windows 11 ARM——内置什么、你需要提供什么，以及为何仍标为实验性。

参考

1vm 命令行

完整命令参考。应用中的每个操作都有对应命令，因为两个前端都是同一核心的客户端。

设置参考

可用 `1vm get` 读取、`1vm set` 修改的每个点分键。

网络

三种网络模式、端口转发，以及哪种需要 Apple 的 entitlement。

SSH

从 Mac 经 SSH 访问来宾 — 哪个地址真正可用、ssh 配置里添加的一行、密钥、账户与主机密钥信任。

虚拟机包

一台机器是一个文件夹。里面有什么、什么可以安全复制、什么应提交版本控制。

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.

自动化与 JSON

冻结的 `--json` 契约、退出码、一次性任务机器以及 MCP 服务器。

引擎与限制

哪个引擎运行哪种 guest，以及各自的上限—— upfront 说明，而不是事后才发现。

帮助

故障排除

用户实际遇到的失败，以及判断是哪一种问题的命令。

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.