OSX-PROXMOX/README.md

253 lines
8.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div align="center">
# 🚀 Dell R730 ORION - Hybrid Network Infrastructure
## OSX-PROXMOX + NixOS Router + AI Agent + BGP Integration
![GitHub stars](https://img.shields.io/github/stars/luchina-gabriel/osx-proxmox?style=flat-square)
![GitHub forks](https://img.shields.io/github/forks/luchina-gabriel/OSX-PROXMOX?style=flat-square)
![GitHub license](https://img.shields.io/github/license/luchina-gabriel/osx-proxmox?style=flat-square)
![GitHub issues](https://img.shields.io/github/issues/luchina-gabriel/osx-proxmox?style=flat-square)
</div>
---
## 🎯 ORION Hybrid Architecture
This repository combines the power of **OSX-PROXMOX** for macOS virtualization with a complete enterprise-grade network infrastructure for the **Dell PowerEdge R730 (CQ5QBM2)**.
### ✨ What's Included
-**Proxmox VE** - Enterprise hypervisor with web management
-**NixOS + VyOS Router** - High-performance routing with BGP (AS 394955)
-**AI Autonomous Agent** - Intelligent network monitoring and self-healing
-**macOS Sequoia** - Full macOS 15 support for development
-**iDRAC Automation** - Complete remote management via Redfish API
-**Prometheus + Grafana** - Real-time monitoring and dashboards
-**BGP Routing** - Multi-peer BGP with Telus (AS 6939)
### 🚀 Quick Start (ORION Hybrid)
```bash
# Clone repository
git clone https://github.com/luci-digital/luci-macOSX-PROXMOX.git
cd luci-macOSX-PROXMOX
# Install dependencies
pip3 install requests
# Run automated deployment
python3 deploy-orion-hybrid.py
```
**Documentation**:
- 📘 [Hybrid Architecture Guide](ORION_HYBRID_ARCHITECTURE.md) - Complete architecture documentation
- 🚀 [Quick Start Guide](QUICKSTART_HYBRID.md) - Get started in 5 minutes
- 🔧 [VM Configurations](vm-configs/README.md) - NixOS configuration files
- 📊 [Proxmox Integration](DELL_R730_ORION_PROXMOX_INTEGRATION.md) - Dell R730 specific setup
### 🏗️ Architecture Overview
```
Dell R730 ORION (384GB RAM, 56 threads)
├─ Proxmox VE 8.x (Hypervisor)
│ ├─ VM 200: NixOS + VyOS Router (8 cores, 32GB)
│ │ └─ BGP, Firewall, DHCP, DNS, NAT
│ ├─ VM 300: AI Agent (4 cores, 16GB)
│ │ └─ Autonomous monitoring, Prometheus, Grafana
│ └─ VM 100: macOS Sequoia (12 cores, 64GB)
│ └─ Development environment
└─ iDRAC Enterprise - Full remote management
```
### 📦 Repository Structure
```
luci-macOSX-PROXMOX/
├── deploy-orion-hybrid.py # Main deployment automation
├── deploy-orion.sh # Legacy Proxmox deployment
├── orion-config.json # Hardware & VM configuration
├── vm-configs/ # NixOS VM configurations
│ ├── router-vm/ # Router VM (NixOS + VyOS)
│ └── ai-agent-vm/ # AI monitoring agent
├── ORION_HYBRID_ARCHITECTURE.md # Full architecture docs
├── QUICKSTART_HYBRID.md # Quick start guide
└── tools/ # Utility scripts
```
### 🌟 Key Features
**Hybrid Design**: Best of both worlds - virtualization flexibility with bare-metal routing performance
**Full Automation**: Deploy entire stack with one command via iDRAC Redfish API
**Declarative Configuration**: NixOS-based router and AI agent for reproducible deployments
**AI-Powered Monitoring**: Autonomous agent that monitors, alerts, and self-heals network issues
**BGP Routing**: Production-grade routing with BIRD2, supporting multi-peer BGP
**macOS Development**: Native macOS Sequoia environment via OSX-PROXMOX
---
## 🍎 Original OSX-PROXMOX Guide
![v15 - Sequoia](https://github.com/user-attachments/assets/4efd8874-dbc8-48b6-a485-73f7c38a5e06)
The following guide provides the original OSX-PROXMOX installation method for running macOS on Proxmox VE with 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.
* Preliminary support for Proxmox VE V9.0.0 BETA.
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!
![osx-terminal](https://github.com/user-attachments/assets/ea81b920-f3e2-422e-b1ff-0d9045adc55e)
---
## 🔧 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 doesnt move on your external display, you need to disable “above 4g decoding” in the motherboards 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)