Docs · शुरुआत

इंस्टॉलेशन

1VMTool को क्या चाहिए, कैसे install करें, और app को particular तरीके से signed क्यों होना चाहिए।

1VMTool एक single application है। साथ में install करने के लिए कोई runtime नहीं, download करने के लिए hypervisor नहीं, और package manager involved नहीं।

Requirements

MacApple silicon। Intel build नहीं है।
macOS26 या बाद का।
Diskजितनी machines आप बनाएंगे उतनी। Disks sparse हैं, इसलिए guest write करने पर grow होती हैं, 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 करें और open करें। पहली launch पर macOS signature और notarization verify करता है; उसके बाद straight away open होता है, network बिना भी।

Command line

1vm app bundle के अंदर ship होता है ताकि दो front ends अलग न हों। अपने PATH पर link करें:

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

App जो कर सकता है, 1vm भी — देखें 1vm command line।

Signing क्यों matter करता है

App में com.apple.security.virtualization entitlement होना चाहिए वरना हर machine start fail होगी। Virtualization.framework use करने वाले process के लिए यह Apple requirement है, और first-party engine को additionally hypervisor entitlement चाहिए।

आपके लिए practical consequence: binary को app bundle से बाहर mat move करें, signature mat strip करें। Source से build करें तो packaging script release step की जगह build का हिस्सा sign करता है, ताकि local build mysteriously broken कभी न हो।

Machines कहाँ store होती हैं

Default में machines home directory में folders की library के रूप में रहती हैं। ONEVM_HOME set करें कहीं और रखने के लिए — external SSD, उदाहरण:

export ONEVM_HOME=/Volumes/Fast/vms

हर machine self-contained folder है। देखें VM bundle।

Host check करें

1vm doctor host, entitlements, library और दोनों engines report करता है, और 1vm capabilities print करता है इस Mac क्या कर सकता और नहीं — nested virtualization, उदाहरण, feature-detected है assume नहीं।

1vm doctor
1vm capabilities