{{Header}} {{hide_all_banners}} {{VirtualBox_CSS}}
{{Title|title=
{{project_name_long}} for macOS: Download and Installation
}}
{{#seo:
|description={{project_name_short}} for Apple macOS on Intel-based MacBook and Apple Silicon.
|image=logo-apple-500x500.png
}}
[[File:logo-apple-500x500.png|thumb|link=|class=hide-enlarge|100px|macOS]]
{{intro|
{{project_name_short}} for '''Apple macOS''' on '''Intel-based MacBook''' and '''Apple Silicon.'''

'''Select''' your hardware platform below.
}}
{{Tab
|type=controller
|content=
{{Tab
|title= = Intel-based MacBook =
|image=[[File:Apple-with-intel-logo.jpg]]
|addToClass=info-box
|content=
[[File:Apple-with-intel-logo.jpg|thumb|100px]]
{{mbox
|icon=fa-solid fa-info cs-red-light
|text=
For Mac computers with an <u>Intel</u> processor, {{project_name_short}} can be run inside VirtualBox.

Follow the documentation on the '''[[VirtualBox]]''' wiki page.
}}<!-- close mbox -->
}}<!-- close tab Intel -->

{{Tab
|title= = Apple Silicon =
|image=[[File:Apple-mx-logo.jpg]]
|addToClass=info-box
|content=
{{Anchor|M1}}{{Anchor|M2}}
[[File:Apple-mx-logo.jpg|thumb|100px]]
'''For Mac <u>M1</u>, <u>M2</u>, ...'''

{{IntroLike|
{{project_name_short}} is not yet available for Mac M1, M2, ... No {{ETA}}. No need to ask for status updates. Any updates would certainly be posted in the usual channels, see [[Stay Tuned]].
}}

{{Unsupported}}

{{mbox
| type    = notice
| image   = [[File:Ambox_notice.png|40px|alt=Info]]
| text    = At time of writing, running {{project_name_short}} on Apple Silicon is still for developers only!
}}<!-- close mbox -->

}}<!-- close tab Apple Silicon -->

{{Tab
|title= = non-Apple Hardware Hackintosh =
|image=[[File:Hackintosh-logo.svg]]
|addToClass=info-box
|content=
{{Community_Support|scope=chapter}}
[[File:Hackintosh-logo.svg|thumb|100px]]

Virtualization on <code>osx86</code> aka "Hackintosh" machines with unmodified "vanilla" kernels works well, but some additional BIOS/UEFI settings need to be confirmed to ensure system stability. As of November 2018 [https://en.wikipedia.org/wiki/VT-d Intel VT-d] is not recommended, although some systems may function if it is enabled. Later BIOS revisions from American Megatrends Inc. (AMI) seem to have improved support compared to earlier releases.

[https://en.wikipedia.org/wiki/AMD-V#I/O_MMU_virtualization_(AMD-Vi_and_Intel_VT-d) AMD-Vi] is not supported, since kernel modifications violating Apple Inc.'s End User License Agreement (EULA) are required to run macOS on platforms other than Intel. It is also recommended to disable the Integrated Graphics Processing Unit (IGPU) if [https://en.wikipedia.org/wiki/PCI_Express PCIe graphics] are in use, as well as disabling any SuperIO/Serial Port options if listed in BIOS. If virtualization problems related to unsupported architectures or features are encountered, please first consult appropriate community forums and wikis available on the Internet.
}}<!-- close tab Hackintosh -->
}}<!-- close tab controller -->

= Miscellaneous macOS Advice =
<div class="toccolours mw-collapsible mw-collapsed"  >
For miscellaneous advice, please press on learn more on the right.
<div class="mw-collapsible-content">
{{Community_Support|scope=chapter}}

If the same VMs will be used on multiple systems like Boot Camp or even two different physical machines, then they can be moved to a shared or external hard drive:

# Copy the VirtualBox VMs folder mentioned earlier to the new location.
# Select the VMs you moved and then click remove.
# When prompted, select "Delete files".
# Re-add the VMs from their new location by selecting <code>Machine=>Add</code>, then navigating to the new folder.

[https://en.wikipedia.org/wiki/ExFAT exFAT] is the easiest format for cross platform file sharing with Windows and Linux. exFAT is an option built into Apple's "Disk Utility.app" when initializing or reformatting a storage device. Select exFAT from the drop down menu that appears when you click "Erase". The default option is HFS+ on 10.13 "High Sierra" and earlier and APFS on 10.14 "Mojave".

Note that with its [https://en.wikipedia.org/wiki/POSIX POSIX] kernel and BSD roots, many issues that arise on macOS hosts can be addressed using strategies similar to other Unix-like OSes.
</div>
</div>

= See Also =
* [[Documentation|Documentation]]
* [[Stay Tuned|Stay Tuned]]

{{reflist|close=1}}
{{Footer}}
[[Category:Documentation]]