Docs · はじめに

インストール

1VMTool に必要なもの、インストール方法、およびアプリを特定の方法で署名する必要がある理由。

1VMTool は単一のアプリケーションです。別途インストールするランタイム、ダウンロードするハイパーバイザ、パッケージマネージャはありません。

要件

MacApple silicon。Intel 版はありません。
macOS26 以降。
Disk作成するマシンに十分な容量。ディスクはスパースなので、事前割り当てではなくゲストが書き込むにつれて増えます。
Everything elseなし。QEMU、Homebrew、Docker、カーネル拡張は不要。

Apple silicon 要件はパッケージングの選択ではありません。両エンジンは CPU 上でゲストコードをネイティブ実行するため、ゲストは ARM64 である必要があります。ここでは外部命令セットをエミュレートしないため、どの Mac でも x86 ゲストはサポートされません。

インストール

1VM.app を /Applications にドラッグして開きます。初回起動時、macOS が署名と公証を検証します。その後はネットワークなしでもすぐに開きます。

コマンドライン

1vm はアプリバンドル内に同梱され、2 つのフロントエンドが乖離しないようにしています。PATH にリンクします:

ln -sf /Applications/1VM.app/Contents/MacOS/1vm /usr/local/bin/1vm
1vm --version

アプリができることはすべて 1vm でもできます — 1vm コマンドライン を参照。

署名が重要な理由

アプリは com.apple.security.virtualization エンタイトルメントを持たないと、すべてのマシンが起動に失敗します。Virtualization.framework を使用するプロセスに対する Apple の要件であり、ファーストパーティエンジンにはさらにハイパーバイザエンタイトルメントが必要です。

実際の影響: バイナリをアプリバンドルから移動したり、署名を剥がしたりしないでください。ソースからビルドする場合、パッケージングスクリプトはリリース手順ではなくビルドの一部として署名するため、ローカルビルドが謎の理由で壊れることはありません。

マシンの保存場所

デフォルトでは、マシンはホームディレクトリ内のフォルダライブラリに保存されます。ONEVM_HOME を設定して別の場所に保存できます — 例: 外付け SSD:

export ONEVM_HOME=/Volumes/Fast/vms

各マシンは自己完結型フォルダです。VM バンドル を参照。

ホストの確認

1vm doctor はホスト、エンタイトルメント、ライブラリ、両エンジンを報告します。 1vm capabilities はこの特定の Mac ができることとできないことを出力します — ネストされた仮想化などは想定ではなく機能検出されます。

1vm doctor
1vm capabilities