ここから始めてください:

1vm doctor          # host, entitlements, library, engines
1vm capabilities    # what this specific Mac can and cannot do
1vm logs <vm>       # guest serial and host lifecycle logs

logs は --source guest|host|all、--lines N、--follow を受け付けます。多くの「ただ失敗した」質問は、ゲスト serial の最後の数行で答えが得られます。

すべてのマシンが起動に失敗する

ほぼ常に署名の問題です。アプリは virtualization エンタイトルメントを持つ必要があるため、バンドルから移動されたか署名が剥がされたバイナリは何も起動できません。断片をコピーするのではなく、元のアプリから再インストールしてください。1vm doctor はエンタイトルメント状態を直接報告します。

マシンは running だがディスプレイがない

1vm logs <vm> --source guest を確認してください。仮想 CPU が存在するマシンは、ファームウェアがゲストまで到達しなくても running と報告されます — 「running」+ 黒画面は通常、エンジンより上のブート失敗を意味し、ウィンドウ欠落ではありません。

Virtualization.framework フォールバックエンジン上の Windows では、ディスプレイドライバがバインドするまで Setup 画面が黒いのは想定内です。ドライバなしで Setup を表示する ramfb がある 1VM エンジンを使用してください。

x86 ISO が起動しない

起動できません。両エンジンは Apple silicon 上でゲストコードをネイティブ実行するため、ゲストは ARM64 である必要があります。エミュレーション経路も変換もありません — OS の ARM64 ビルドが必要です。これが最も一般的な驚きであり、Omarchy ガイドが詳しく説明する理由です。

Windows にネットワークがない

virtio-win の NetKVM ドライバをインストールしてください。Windows には NVMe と xHCI の内蔵ドライバがあるためディスクとキーボードはすぐ動作しますが、virtio-net にはありません。作成時に --drivers でドライバ ISO を接続してください。

インストール中にゲストがメモリ不足

インストーラは実行中システムではなくメモリのピークです。マシンにメモリを増やして再試行:

1vm stop dev --force
1vm set dev memory 8GiB
1vm start dev

Mac 自体が逼迫している場合、1VMTool はプロファイルを下げ、黙ってオーバーコミットするのではなく通知します。

キーボードがゲストに固定されている

リリースコードをタップ — コンソールのステータスストリップにそのウィンドウで有効な組み合わせが表示されます。設定可能:

1vm get dev input.releaseChord

設定が変更できない

実行中マシンのハードウェア変更は、設定が明示的にサポートしない限り拒否されます。マシンを停止、変更、起動。設定は設定時に検証されるため、エラーは次回起動時ではなく実際の問題を示します。

スクリプトがハングまたはレースする

sleep ではなく 1vm wait-ready <vm> を使用してください。「running」はマシンが実行中、「ready」は SSH またはゲストエージェント経由でゲストに到達可能であることを意味します。そのギャップが不安定なスクリプトの栖家です。

動作する状態に戻す

1vm discard-session dev --force   # undo everything since this boot
1vm snapshot restore dev clean    # go to a named snapshot
1vm reset dev --force             # back to the clean state

スナップショットを取らずに済ませたなら、今が始めるタイミングです。コストはゼロ — それが要点です。