Updated: 10 August 2026
Dortania's OpenCore Install Guide represents the community gold standard for creating vanilla, reliable, and maintainable macOS configurations on non-Apple x86 hardware. This guide provides actionable advice on how to navigate Dortania's documentation, avoid common pitfalls, and validate your setup.
1. Essential ACPI SSDTs by Platform
Never use generic, full DSDT replacements. Build a clean ACPI directory using targeted SSDTs tailored for your CPU generation:
| CPU Platform | Mandatory SSDTs | Primary Purpose |
|---|---|---|
| Intel Desktop (10th Gen Comet Lake) | SSDT-PLUG, SSDT-EC-USBX, SSDT-AWAC, SSDT-RHUB |
CPU power management, legacy RTC/AWAC clock fix, and USB controller reset. |
| Intel Desktop (12th–14th Gen) | SSDT-PLUG-ALT, SSDT-EC-USBX, SSDT-AWAC |
Alder Lake power management definition and ACPI Embedded Controller compliance. |
| AMD Desktop (Zen / Ryzen) | SSDT-CPUR (B550/A520 only), SSDT-EC-USBX |
Embedded Controller power injection and Ryzen memory bus device assignment. |
| Intel Laptops (8th–10th Gen) | SSDT-PLUG, SSDT-EC-USBX, SSDT-PNLF, SSDT-GPI0 |
CPU power, backlight control, and I2C precision touchpad interrupt routing. |
2. The Golden Rules of Dortania Configuration
- Build from Scratch: Avoid downloading pre-built EFIs from YouTube, GitHub repos, or discussion forums. Pre-built EFIs contain duplicate ACPI tables, incorrect serial numbers, and mismatched quirks.
- Match Your Exact Hardware: Review every section of the guide corresponding to your specific processor family (Desktop vs Laptop, Comet Lake vs Alder Lake vs Ryzen).
- Use ProperTree for Snapshots: Always run Clean Snapshot (
Cmd/Ctrl + Shift + R) in ProperTree to accurately populateKernel -> Add,ACPI -> Add, andDrivers.
3. Pre-Boot Verification with ocvalidate
Before testing an updated EFI, open your terminal and run ocvalidate from your OpenCore Utilities folder:
./Utilities/ocvalidate/ocvalidate /Volumes/EFI/EFI/OC/config.plistFix any listed syntax errors, mismatched types, or deprecated quirk keys until you achieve "Completed validating, no issues found."
Reliable Starting Points
- Dortania OpenCore Install Guide — Primary guide documentation.
- Getting Started with ACPI — Official SSDT creation and compilation guide.