Docs · Bantuan

Troubleshooting

Kegagalan yang benar-benar dialami orang, dan perintah yang memberi tahu yang mana.

Mulai di sini:

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 menerima --source guest|host|all, --lines N dan --follow. Kebanyakan pertanyaan "langsung gagal" dijawab beberapa baris serial guest terakhir.

Setiap mesin gagal start

Hampir selalu signature. App harus bawa entitlement virtualisasi, jadi binary yang dipindah keluar bundle atau signature di-strip tidak bisa start apa pun. Reinstall dari app asli alih-alih copy potongan. 1vm doctor laporkan state entitlement langsung.

Mesin bilang running tapi tidak ada tampilan

Periksa 1vm logs <vm> --source guest. Mesin yang vCPU virtual ada dilaporkan running meski firmware tidak sampai guest — jadi "running" plus layar hitam biasanya boot failure di atas engine, bukan jendela hilang.

Untuk Windows di engine fallback Virtualization.framework, layar Setup hitam expected sampai driver tampilan bind. Gunakan engine 1VM, di mana ramfb nyalakan Setup tanpa driver.

ISO x86 tidak boot

Tidak bisa. Kedua engine jalankan kode guest native di Apple silicon, jadi guest harus ARM64. Tidak ada jalur emulasi dan konversi — butuh build ARM64 OS. Kejutan paling umum, dan panduan Omarchy jelaskan penuh.

Windows tidak ada jaringan

Install driver NetKVM virtio-win. Windows punya driver in-box NVMe dan xHCI, itulah mengapa disk dan keyboard langsung bekerja, tapi bukan virtio-net. Lampirkan ISO driver saat create dengan --drivers.

Guest kehabisan memori saat install

Installer adalah high-water mark memori, bukan sistem running. Beri mesin lebih dan coba lagi:

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

Jika Mac sendiri under pressure, 1VMTool skala profil turun dan beri tahu alih-alih overcommit diam-diam.

Keyboard stuck di guest

Tap release chord — status strip console tunjukkan kombinasi aktif untuk jendela itu. Bisa dikonfigurasi:

1vm get dev input.releaseChord

Setting tidak bisa diubah

Perubahan hardware pada mesin running ditolak kecuali setting eksplisit mendukung. Stop mesin, ubah, start. Settings divalidasi saat set, jadi error sebut masalah nyata alih-alih gagal boot berikutnya.

Skrip hang atau race

Gunakan 1vm wait-ready <vm> alih-alih sleep. "Running" berarti mesin executing; "ready" berarti guest dapat dijangkau SSH atau guest agent. Celah di antara mereka tempat skrip flaky hidup.

Kembali ke state bekerja

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

Jika lewati snapshot, ini saat mulai: gratis, dan itulah intinya.