Docs · Memulai

Instalasi

Apa yang 1VMTool butuhkan, cara install, dan mengapa app harus ditandatangani cara tertentu.

1VMTool adalah satu aplikasi. Tidak ada runtime install di sampingnya, hypervisor download, atau package manager terlibat.

Persyaratan

MacApple silicon. Tidak ada build Intel.
macOS26 atau lebih baru.
DiskCukup untuk mesin yang Anda buat. Disk sparse, jadi tumbuh saat guest menulis bukan di awal.
Everything elseTidak ada. Tanpa QEMU, Homebrew, Docker, kernel extension.

Persyaratan Apple silicon bukan pilihan packaging. Kedua engine menjalankan kode guest native di CPU, jadi guest harus ARM64. Tidak ada emulasi instruction set asing, itulah mengapa tidak ada dukungan guest x86 di Mac mana pun.

Install

Drag 1VM.app ke /Applications dan buka. Saat launch pertama macOS memverifikasi signature dan notarisasi; setelah itu langsung terbuka, termasuk tanpa jaringan.

Baris perintah

1vm dikirim di dalam app bundle agar dua front end tidak drift. Link ke PATH Anda:

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

Apa pun app bisa lakukan, 1vm bisa — lihat Baris perintah 1vm.

Mengapa signing penting

App harus membawa entitlement com.apple.security.virtualization atau setiap mesin gagal start. Ini persyaratan Apple untuk proses yang memakai Virtualization.framework, dan engine first-party additionally butuh entitlement hypervisor.

Konsekuensi praktis: jangan pindahkan binary keluar app bundle, dan jangan strip signature. Build dari source, skrip packaging sign sebagai bagian build bukan langkah release, agar build lokal tidak pernah mysteriously broken.

Di mana mesin disimpan

Default mesin ada di home directory sebagai library folder. Set ONEVM_HOME untuk menyimpan di tempat lain — SSD eksternal, misalnya:

export ONEVM_HOME=/Volumes/Fast/vms

Setiap mesin folder self-contained. Lihat VM bundle.

Periksa host

1vm doctor melaporkan host, entitlements, library dan kedua engine, dan 1vm capabilities mencetak apa Mac spesifik ini bisa dan tidak — nested virtualization misalnya feature-detected bukan diasumsikan.

1vm doctor
1vm capabilities