# VirtualBox/Setting up a Virtual Machine/Mac OS X
## Disclaimer

Mac OS X and newer versions have had a long standing clause in their software license agreements that permits the use of macOS only on computers made by Apple. If Apple has released a version above Sonoma, confirm eligibility by referring to the given agreement for the new OS version at this link.
Otherwise, performing anything in this guide could run you into legal trouble with Apple. For non-Mac users, proceed at your own risk.

## Compatibility

macOS Catalina 10.15.2 and 10.15.3 (and possibly every later version) are only compatible with VirtualBox version 6.1.4 or greater.

## Installation script

The following installation script:
* ...is free and open-source
* ...requires only VirtualBox with its Extension Pack and dependencies that can be easily installed in a single command with most open-source package managers
* ...downloads macOS Catalina, Mojave and High Sierra directly from Apple's servers
* ...installs macOS without modifying the original Apple binaries and without third-party bootloaders
* ...creates a VM that is compatible with OpenCore and can be exported (with manual modifications) to KVM/QEMU for near-native performance
* ...runs on Linux, Windows (WSL 1, Cygwin), and macOS
https://github.com/myspaghetti/macos-guest-virtualbox - Push-button installer of macOS on VirtualBox

## Manual installation

The manual installation requires access to the Mac App Store through an existing installation of macOS.

### Create ISO Installation Media (not working to create iso for macOS version 12+)

* Download the macOS Installer file from the App Store (OS X El Capitan and Sierra is downloadable from Apple's website).
* When download finishes, find the app, right-click and select "Show Package Contents".
* Inside the sub-folder Contents/SharedSupport you will find a InstallESD.dmg file, Right click and copy it to the desktop or your file of choice
* Open "Disk Utility"
* Choose Images > Convert
* In the window, choose the InstallESD.dmg and the disk type to be "DVD/CD-R master for export". Also choose the name for installer disk and the final destination (if it lets you). Then click "Convert".
* After the conversion completes, you will see a .cdr file in your destination folder.
* Open "Terminal"
* Enter hdiutil convert /Your/Path/To/YourCdrFile.cdr -format UDTO -o /Your/Path/To/macOSInstaller.iso (for file paths, You can also just click and drag an item into the terminal to automatically type the file path, use left and right arrow keys to navigate)
* Press enter and wait for the process to complete.
* Check your output folder for the file
* The file outputted will have the extra extension of dmg once this process is completed. Simply rename the File to .iso, it will ask you if you want to keep this title just say yes. (if your file isn't like this ignore this step)

### Installation in VirtualBox

* Open VirtualBox. Click "new"
* Type the name for virtual machine and Mac OS X for type. Choose your version (if you have Mojave or Catalina, choose Mac OS X (64 bit)).
* Select memory size.
* Select "Create Virtual Disk Now"
* Choose VDI for format.
* Select storage name and size. The size should be at least 32 GB.
* Go to "Settings"
* Go to "Storage" Tab
* In the SATA controller, click "Add Optical Disk".
* Insert the .iso file.
* Go to "Display" tab.
* Set video memory to maximum value.
* Quit "Settings"
* Boot by clicking "Start".
* When it boots, you will see some data being displayed.
* This part needs clarification - UEFI Interactive Shell loads, but nothing happens. If you use the command "exit" you can shift to the EFI menu, but changing the settings doesn't seem to affect the progress of the UEFI Interactive Shell, which stops at the Shell> prompt.
* After a while, you will need to choose the language for installation. Choose your own language.
* Then you will be asked where to install macOS.
* On the upper-left corner, you will see a "Utilities" button. Click it and select "Disk Utility".
* You will see a window with different storages on the left. Choose "VBOX HARDDISK Media". Note: You may have to select View/View All Devices
* Erase the Storage by clicking the "Erase" button on the top.
* You will be prompted to enter the name for the storage. Enter your desired name and continue.
* Wait for the process to complete. Then quit Disk Utility.
* You will find a new storage media, which is like a hard disk. Choose that storage for the installation of OS X to install.
* After installation completes, the virtual machine will automatically shut down. Go to "Settings".
* Go to the "Storage" section to eject the .iso file.
* Boot virtual machine again.
* Choose system language.
* Choose allow location or not.
* You will be asked to enter your Apple ID. Even if you have an Apple ID, do not enter now.
* Accept EULA of macOS.
* Restore Time Machine Backups (if you have)
* You will see the main page of OS X, open App Store.
* Enter your Apple ID and sign in...
There should be 2 scenarios...
* Scenario 1: You will sign in within a short time. Congratulations! You have done it!
* Scenario 2: It took ages. Stop signing in and check the references below.

## References

* ↑ Apple Inc. "SOFTWARE LICENSE AGREEMENT FOR macOS Sonoma" (PDF). § 2B(iii). Retrieved 2024-04-24. ...subject to the terms and conditions of this License and as permitted by the Services and Content Usage Rules set forth in the Apple Media Services Terms and Conditions (...) ("Usage Rules"), you are granted a limited, non-transferable, non-exclusive license (...) to install, use and run up to two (2) additional copies or instances of the Apple Software, or any prior macOS or OS X operating system software or subsequent release of the Apple Software, within virtual operating system environments on each Apple-branded computer you own or control that is already running the Apple Software, for purposes of: (a) software development; (b) testing during software development; (c) using macOS Server; or (d) personal, non-commercial use.
* 1 2 https://support.apple.com/en-us/HT201475