f0baf4a6ac
This was inspired by df228d4cbd
That fix would have broken my system that uses local-zfs for virtual machines.
My fix has a function simular to the one that detects virtual machine storage, and if there is more than one for ISO's, it will prompt for the one to use.
166 lines
5.4 KiB
Markdown
166 lines
5.4 KiB
Markdown
<div align="center">
|
||
|
||
# 🚀 OSX-PROXMOX - Run macOS on ANY Computer (AMD & Intel)
|
||
|
||
|
||
|
||
|
||
|
||
|
||
</div>
|
||
|
||
|
||
Easily install macOS on Proxmox VE with just a few steps! This guide provides the simplest and most effective way to set up macOS on Proxmox, whether you're using AMD or Intel hardware.
|
||
|
||
---
|
||
|
||
## 🛠 Installation Guide
|
||
|
||
1. Install a **FRESH/CLEAN** version of Proxmox VE (v7.0.XX ~ 8.4.XX) - just follow the Next, Next & Finish (NNF) approach.
|
||
2. Open the **Proxmox Web Console** → Navigate to `Datacenter > YOUR_HOST_NAME > Shell`.
|
||
3. Copy, paste, and execute the command below:
|
||
|
||
```bash
|
||
/bin/bash -c "$(curl -fsSL https://install.osx-proxmox.com)"
|
||
```
|
||
|
||
🎉 Voilà! You can now install macOS!
|
||
|
||
---
|
||
|
||
## 🔧 Additional Configuration
|
||
|
||
### Install EFI Package in macOS (Disable Gatekeeper First)
|
||
|
||
```bash
|
||
sudo spctl --master-disable
|
||
```
|
||
|
||
---
|
||
|
||
## 🍏 macOS Versions Supported
|
||
✅ macOS High Sierra - 10.13
|
||
✅ macOS Mojave - 10.14
|
||
✅ macOS Catalina - 10.15
|
||
✅ macOS Big Sur - 11
|
||
✅ macOS Monterey - 12
|
||
✅ macOS Ventura - 13
|
||
✅ macOS Sonoma - 14
|
||
✅ macOS Sequoia - 15
|
||
|
||
---
|
||
|
||
## 🖥 Proxmox VE Versions Supported
|
||
✅ v7.0.XX ~ 8.4.XX
|
||
|
||
### 🔄 OpenCore Version
|
||
- **April/2025 - 1.0.4** → with SIP Enabled, DMG only signed by Apple and all features of securities
|
||
|
||
---
|
||
|
||
## ☁️ Cloud Support (Run Hackintosh in the Cloud!)
|
||
- [🌍 VultR](https://www.vultr.com/?ref=9035565-8H)
|
||
- [📺 Video Tutorial](https://youtu.be/8QsMyL-PNrM) (Enable captions for better understanding)
|
||
- Now has configurable bridges, and can add as many bridges and specify the subnet for them.
|
||
|
||
---
|
||
|
||
## ⚠️ Disclaimer
|
||
|
||
🚨 **FOR DEVELOPMENT, STUDENT, AND TESTING PURPOSES ONLY.**
|
||
|
||
I am **not responsible** for any issues, damage, or data loss. Always back up your system before making any changes.
|
||
|
||
---
|
||
|
||
## 📌 Requirements
|
||
|
||
Since macOS Monterey, your host must have a **working TSC (timestamp counter)**. Otherwise, if you assign multiple cores to the VM, macOS may **crash due to time inconsistencies**. To check if your host is compatible, run the following command in Proxmox:
|
||
|
||
```bash
|
||
dmesg | grep -i -e tsc -e clocksource
|
||
```
|
||
|
||
### ✅ Expected Output (for working hosts):
|
||
```
|
||
clocksource: Switched to clocksource tsc
|
||
```
|
||
|
||
### ❌ Problematic Output (for broken hosts):
|
||
```
|
||
tsc: Marking TSC unstable due to check_tsc_sync_source failed
|
||
clocksource: Switched to clocksource hpet
|
||
```
|
||
|
||
### 🛠 Possible Fixes
|
||
1. Disable "ErP mode" and **all C-state power-saving modes** in your BIOS. Then power off your machine completely and restart.
|
||
2. Try forcing TSC in GRUB:
|
||
- Edit `/etc/default/grub` and add:
|
||
```bash
|
||
clocksource=tsc tsc=reliable
|
||
```
|
||
- Run `update-grub` and reboot (This may cause instability).
|
||
3. Verify the TSC clock source:
|
||
```bash
|
||
cat /sys/devices/system/clocksource/clocksource0/current_clocksource
|
||
```
|
||
The output **must be `tsc`**.
|
||
|
||
[Read More](https://www.nicksherlock.com/2022/10/installing-macos-13-ventura-on-proxmox/comment-page-1/#comment-55532)
|
||
|
||
---
|
||
|
||
## 🔍 Troubleshooting
|
||
|
||
### ❌ High Sierra & Below - *Recovery Server Could Not Be Contacted*
|
||
|
||
If you encounter this error, you need to switch from **HTTPS** to **HTTP** in the installation URL:
|
||
|
||
1. When the error appears, leave the window open.
|
||
2. Open **Installer Log** (`Window > Installer Log`).
|
||
3. Search for "Failed to load catalog" → Copy the log entry.
|
||
4. Close the error message and return to `macOS Utilities`.
|
||
5. Open **Terminal**, paste the copied data, and **remove everything except the URL** (e.g., `https://example.sucatalog`).
|
||
6. Change `https://` to `http://`.
|
||
7. Run the command:
|
||
|
||
```bash
|
||
nvram IASUCatalogURL="http://your-http-url.sucatalog"
|
||
```
|
||
|
||
8. Quit Terminal and restart the installation.
|
||
|
||
[Reference & More Details](https://mrmacintosh.com/how-to-fix-the-recovery-server-could-not-be-contacted-error-high-sierra-recovery-is-still-online-but-broken/)
|
||
|
||
### ❌ Problem for GPU Passthrough
|
||
|
||
If you see an Apple logo and the bar doesn’t move on your external display, you need to disable “above 4g decoding” in the motherboard’s BIOS.
|
||
|
||
In some environments it is necessary to segment the IOMMU Groups to be able to pass the GPU to the VM.
|
||
|
||
1. Add the content `pcie_acs_override=downstream,multifunction pci=nommconf` in the file `/etc/default/grub` at the end of the line `GRUB_CMDLINE_LINUX_DEFAULT`;
|
||
2. After changing the grub file, run the command `update-grub` and reboot your PVE.
|
||
|
||
---
|
||
|
||
## 🎥 Demonstration (in Portuguese)
|
||
|
||
📽️ [Watch on YouTube](https://youtu.be/dil6iRWiun0)
|
||
*(Enable auto-translate captions for English subtitles!)*
|
||
|
||
---
|
||
|
||
## 🎖 Credits
|
||
|
||
- **OpenCore/Acidanthera Team** - Open-source bootloader
|
||
- **Corpnewt** - Tools (ProperTree, GenSMBIOS, etc.)
|
||
- **Apple** - macOS
|
||
- **Proxmox** - Fantastic virtualization platform & documentation
|
||
|
||
---
|
||
|
||
## 🌎 Join Our Community - Universo Hackintosh Discord
|
||
|
||
💬 [**Join Here!**](https://discord.universohackintosh.com.br)
|
||
|