27 lines
2.8 KiB
Markdown
27 lines
2.8 KiB
Markdown
## One-key semi-automatic installer of macOS Mojave 10.14.3 on VirtualBox
|
|
|
|
The "one key" is enter, which has to be pressed whenever the virtual machine is ready for the next command. (Contrary to the script's name, the user has to use more than one key! There is one instance when the "host key" is used to release the mouse from the virtual machine, and one instance where the user has to choose [y]es or [n]o!)
|
|
|
|
The goal of the script is to allow for a very easy installation without any closed-source additions or extra bootloaders.
|
|
|
|
Tested on Cygwin, should work on Linux distros.
|
|
|
|
## iCloud and iMessage connectivity
|
|
|
|
iCloud and iMessage and other connected Apple services require a valid device serial number. Set it before the installation by replacing `NOTAVALIDSN0` with a valid serial number, or after the installation with `VBoxManage setextradata "${vmname}" "VBoxInternal/Devices/efi/0/Config/DmiSystemSerial" "${serialnumber}"`. An invalid serial number that matches the correct structure for the device name and board ID might work, too.
|
|
|
|
## Storage size
|
|
|
|
The script assigns the minimum required storage size for the installation. After the installation is complete, the virtual disk image may be increased through VirtualBox, and then the macOS system partition size may be increased through Disk Utility inside the virtual machine by creating a new APFS container and subsequently deleting it, allowing the system APFS container to take up the space.
|
|
|
|
## Unsupported features (audio, USB devices)
|
|
|
|
Hosting a macOS virtual machine on Windows or Linux running on a Mac computer may be fine by some reading of the macOS license ([*B. you are granted a limited, non-transferable, non-exclusive license: (iii) to install, use and run up to two (2) additional copies or instances of the Apple Software within virtual operating system environments on each Mac 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.*](https://www.apple.com/legal/sla/docs/macOS1014.pdf)) Despite this, Oracle, the company that develops VirtualBox, does not offer VirtualBox support for macOS guests on Windows or Linux hosts, and actively suppresses using VirtualBox for this purpose. This means that some hardware issues like the lack of proper audio and USB support will not be developed or maintained by Oracle. Developing and maintaining such features is beyond the scope of this script.
|
|
|
|
## Dependencies
|
|
|
|
* [VirtualBox](https://www.virtualbox.org/wiki/Downloads)≥5.2 with Extension Pack
|
|
* `Bash`≥4 (run on Windows through [Cygwin](https://cygwin.com/install.html))
|
|
* `unzip`, `wget` (install through package manager)
|
|
* `dmg2img` (install through package manager on Linux; let the script download it automatically on Windows)
|