1VMTool ایک application ہے۔ ساتھ install کرنے کے لیے کوئی runtime نہیں، download کرنے کے لیے hypervisor نہیں، package manager شامل نہیں۔

Requirements


Mac	Apple silicon۔ Intel build نہیں۔
macOS	26 یا بعد۔
Disk	جو machines بنائیں ان کے لیے کافی۔ Disks sparse ہیں، guest لکھنے پر
بڑھتے ہیں، upfront نہیں۔
Everything else	کچھ نہیں۔ QEMU، Homebrew، Docker، kernel extension نہیں۔

Apple-silicon requirement packaging choice نہیں۔ دونوں engines guest code CPU پر natively چلاتے ہیں، اس لیے guest ARM64 ہونا چاہیے۔ یہاں foreign instruction set emulate نہیں ہوتی، اس لیے کسی Mac پر x86 guest support نہیں۔

Install

1VM.app کو /Applications میں drag کریں اور کھولیں۔ پہلی launch پر macOS signature اور notarization verify کرتا ہے؛ بعد میں براہِ راست کھلتا ہے، network کے بغیر بھی۔

Command line

1vm app bundle کے اندر ships ہوتا ہے تاکہ دونوں front ends الگ نہ ہوں۔ اپنے PATH پر link کریں:

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

App جو کر سکتا ہے 1vm بھی کر سکتا ہے — The 1vm command line دیکھیں۔

Signing کیوں اہم ہے

App میں com.apple.security.virtualization entitlement ہونا ضروری ہے ورنہ ہر machine start fail ہوگی۔ Virtualization.framework استعمال کرنے والے process کے لیے Apple requirement ہے، اور first-party engine کو hypervisor entitlement بھی چاہیے۔

آپ کے لیے عملی نتیجہ: binary app bundle سے باہر نہ نکالیں، signature نہ strip کریں۔ Source سے build کریں تو packaging script release step کی بجائے build کا حصہ sign کرتی ہے، تاکہ local build mysteriously broken نہ رہے۔

Machines کہاں store ہوتی ہیں

Default میں machines home directory میں library folders کے طور پر۔ کہیں اور رکھنے کے لیے ONEVM_HOME set کریں — مثلاً external SSD:

export ONEVM_HOME=/Volumes/Fast/vms

ہر machine self-contained folder ہے۔ The VM bundle دیکھیں۔

Host check کریں

1vm doctor host، entitlements، library اور دونوں engines report کرتا ہے، 1vm capabilities print کرتا ہے یہ Mac کیا کر سکتا اور نہیں — nested virtualization مثلاً assume نہیں، feature-detected ہے۔

1vm doctor
1vm capabilities