[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-70836":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":10,"rankLanguage":10,"license":18,"archived":19,"fork":20,"defaultBranch":21,"hasWiki":20,"hasPages":20,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":29,"readmeContent":30,"aiSummary":31,"trendingCount":15,"starSnapshotCount":15,"syncStatus":32,"lastSyncTime":33,"discoverSource":34},70836,"macos-virtualbox","myspaghetti\u002Fmacos-virtualbox","myspaghetti","Push-button installer of macOS Catalina, Mojave, and High Sierra guests in Virtualbox on x86 CPUs for Windows, Linux, and macOS","",null,"Shell",13538,1123,1,0,3,44.15,"GNU General Public License v2.0",true,false,"master",[23,24,25,26,27,28],"bash-script","macos","macos-installer","macos-virtual-machine","virtualbox","virtualbox-efi","2026-06-12 02:02:44","\n![macOS inside a VirtualBox window with the dock positioned on the left](https:\u002F\u002Frepository-images.githubusercontent.com\u002F156108442\u002Fc501b100-0e5a-11eb-8b49-90afd63f5d03 \"macos-guest-virtualbox.sh\")\n\n## Push-button installer of macOS on VirtualBox\n\n[`macos-guest-virtualbox.sh`](https:\u002F\u002Fraw.githubusercontent.com\u002Fmyspaghetti\u002Fmacos-guest-virtualbox\u002Fmaster\u002Fmacos-guest-virtualbox.sh) is a Bash script that creates a macOS virtual machine guest on VirtualBox with unmodified macOS installation files downloaded directly from Apple servers.\n\nA default install only requires the user to sit patiently and, less than ten times, press enter when prompted by the script, without interacting with the virtual machine.\n\nTested on `bash` and `zsh` on [Cygwin](https:\u002F\u002Fcygwin.com\u002Finstall.html). Works on macOS, CentOS 7, and Windows on x86 CPUs with VT-x or AMD-V. Should work on most modern Linux distros.\n\nmacOS Catalina (10.15), Mojave (10.14), and High Sierra (10.13) currently supported.\n\n## Maintainer wanted\n\nIf you would like to become the maintainer of this repository, please see [issue #645 - maintainer wanted](https:\u002F\u002Fgithub.com\u002Fmyspaghetti\u002Fmacos-virtualbox\u002Fissues\u002F645).\n\n## Documentation\n\nDocumentation can be viewed by executing the command `.\u002Fmacos-guest-virtualbox.sh documentation`\n\nThe majority of the script is either documentation, comments, or actionable error messages, which should make the script straightforward to inspect and understand.\n\n## iCloud and iMessage connectivity and NVRAM\n\niCloud, iMessage, and other connected Apple services require a valid device name and serial number, board ID and serial number, and other genuine (or genuine-like) Apple parameters. These can be set in EFI and NVRAM by editing the script. See the [documentation command](#documentation) for further information.\n\n## Storage size\n\nThe script by default assigns a target virtual disk storage size of 80GB, which is populated to about 25GB on the host on initial installation. After the installation is complete, the storage size may be increased. See the [documentation command](#documentation) for further information.\n\n## Primary display resolution\n\nThe following primary display resolutions are supported by macOS on VirtualBox: `5120x2880` `2880x1800` `2560x1600` `2560x1440` `1920x1200` `1600x1200` `1680x1050` `1440x900` `1280x800` `1024x768` `640x480`. See the [documentation command](#documentation) for further information.\n\n## Scope and unsupported features\n\nThe scope of the script is completing a default macOS install process on VirtualBox on supported hardware. Further functioning order of VirtualBox or macOS is beyond the scope of this script. Some features may behave unexpectedly, such as USB device support, audio support, FileVault boot password prompt support, and other features, including critical functionality.\n\n### CPU compatibility\n\nThe script is designed for x86 CPU Mac hardware. macOS guests on VirtualBox are generally incompatible with other CPU models. If the guest macOS boot process hangs on “LoadKernelFromStream”, “EndRandomSeed”, or \"EXITBS\", see the [documentation command](#documentation) regarding VirtualBox CPU profiles and [CPUID settings](https:\u002F\u002Fwww.virtualbox.org\u002Fmanual\u002Fch08.html#vboxmanage-modifyvm-teleport). Some CPU models released in 2020 and later may fail to start or complete the installer, and may require manually adjusting the CPUID settings.\n\n### Upgrading to Big Sur and Monterey \n\nThe virtual machine may be upgraded to the latest macOS Big Sur (11) and macOS Monterey (12) versions through Software Update. Big Sur may be installed in-place. Monterey may require attaching another volume to the virtual machine and selecting the volume as the installation target, otherwise the upgrade is prone to failing and entering a boot loop.\n\n### Performance and deployment\n\nAfter successfully creating a working macOS virtual machine, consider importing it into more performant virtualization software, or packaging it for configuration management platforms for automated deployment. These virtualization and deployment applications require additional configuration that is beyond the scope of the script.\n\nQEMU with KVM is capable of providing virtual machine hardware passthrough for near-native performance. QEMU supports the `VMDK` virtual disk image storage format, which can be configured to be created by the script. See the [documentation command](#documentation) for further information. QEMU and KVM require additional configuration that is beyond the scope of the script.\n\n#### VirtualBox Native Execution Manager (NEM)\n\nThe VirtualBox Native Execution Manager (NEM) is an experimental VirtualBox feature. [VirtualBox uses NEM when access to VT-x and AMD-V is blocked by virtualization software or execution protection features such as Hyper-V, WSL2, WSLg, Windows Sandbox, memory integrity protection, Application Guard, Credential Guard, Device Guard, and other features and software.](https:\u002F\u002Fdocs.microsoft.com\u002Fen-us\u002Ftroubleshoot\u002Fwindows-client\u002Fapplication-management\u002Fvirtualization-apps-not-work-with-hyper-v) macOS and the macOS installer have memory corruption issues under NEM virtualization. The script checks for NEM and exits with an error message if it is detected.\n\n[VirtualBox can run on WSL2 and WSLg with some kernel module compilation](https:\u002F\u002Fgithub.com\u002Fmyspaghetti\u002Fmacos-virtualbox\u002Fissues\u002F525), though performance is extremely low. At the point that kernel module compilation is required, it may be preferable to use QEMU\u002FKVM on WSL2 and WSLg, which is orders of magnitude faster than VirtualBox on WSL2 and WSLg. WSL2, WSLg, QEMU, and KVM require additional configuration that is beyond the scope of the script.\n\n### Bootloaders\n\nThe macOS VirtualBox guest is loaded without extra bootloaders, but it is compatible with [OpenCore](https:\u002F\u002Fgithub.com\u002Facidanthera\u002FOpenCorePkg\u002Freleases). OpenCore requires additional configuration that is beyond the scope of  the script.\n\n### Audio\n\nmacOS may not support any built-in VirtualBox audio controllers. The bootloader [OpenCore](https:\u002F\u002Fgithub.com\u002Facidanthera\u002FOpenCorePkg\u002Freleases) may be able to load open-source or built-in audio drivers in VirtualBox, providing the configuration for STAC9221 (Intel HD Audio) or SigmaTel STAC9700,83,84 (ICH AC97) is available.\n\n### Display scaling\n\nVirtualBox does not supply an EDID for its virtual display, and macOS does not enable display scaling (high PPI) without an EDID. The bootloader OpenCore can [inject an EDID](https:\u002F\u002Fgithub.com\u002Facidanthera\u002FWhateverGreen\u002Fblob\u002Fmaster\u002FManual\u002FFAQ.IntelHD.en.md#edid) which enables display scaling.\n\n### FileVault\n\nThe VirtualBox EFI implementation does not properly load the FileVault full disk encryption password prompt upon boot. The bootloader [OpenCore](https:\u002F\u002Fgithub.com\u002Facidanthera\u002FOpenCorePkg\u002Freleases\u002Ftag\u002F0.6.9) is able to load the password prompt with the parameter `ProvideConsoleGop` set to `true`. See sample [config.plist](https:\u002F\u002Fgithub.com\u002Fmyspaghetti\u002Fmacos-virtualbox\u002Ffiles\u002F6600860\u002Fconfig.plist.txt)\n\n\n## Dependencies\n\nThe following dependencies should be available through a package manager:  \n`bash` `coreutils` `gzip` `unzip` `wget` `xxd` `dmg2img`  `virtualbox`\n\nThe following optional packages provide optical character recognition that reduces the required interaction with the script:  \n`tesseract-ocr` `tesseract-ocr-eng`\n\nSupported versions:\n\n* [VirtualBox](https:\u002F\u002Fwww.virtualbox.org\u002Fwiki\u002FDownloads) ≥ 6.1.6, though versions as low as 5.2 may work.\n* GNU `Bash` ≥ 4.3, on Windows run through [Cygwin](https:\u002F\u002Fcygwin.com\u002Finstall.html) or WSL \"1\", see [NEM](#virtualbox-native-execution-manager-nem)\n* GNU `coreutils` ≥ 8.22, GNU `gzip` ≥ 1.5, Info-ZIP `unzip` ≥ v6.0, GNU `wget` ≥ 1.14, `xxd` ≥ 1.11\n* `dmg2img` ≥ 1.6.5, on Cygwin the package is not available through the package manager so the script downloads it automatically.\n* `tesseract-ocr` ≥ 4\n","该项目提供了一个一键安装脚本，用于在VirtualBox中为Windows、Linux和macOS系统安装macOS Catalina、Mojave和High Sierra虚拟机。其核心功能是通过Bash脚本自动下载未修改的macOS安装文件，并创建一个虚拟机环境，整个过程仅需用户少量交互即可完成。该脚本支持多种操作系统上的bash或zsh环境，包括Cygwin下的Windows、CentOS 7等。适用于需要在非苹果硬件上测试或运行macOS应用的开发者，以及希望在个人电脑上体验macOS操作系统的用户。此外，它还允许用户自定义如iCloud连接性、NVRAM设置及存储大小等配置选项，以满足特定需求。",2,"2026-06-11 03:34:27","high_star"]