How to Fix Hackintosh Installation Time Increasing or Getting Stuck During macOS Setup

How to Resolve Stuck Hackintosh Installations and Increasing Remaining Time

When installing macOS on non-Apple hardware using an offline installer, seeing the remaining time increase from a few hours to several hours or having the process freeze completely is a common issue. This behaviour usually points to sub-optimal USB configuration, disk write bottlenecks, or incompatible hardware components.

1. Prerequisites

• Verify Target Hardware: Ensure your hardware meets macOS requirements. Identify your CPU generation (e.g., Intel Coffee Lake, Comet Lake or AMD Ryzen), motherboard chipset, and storage drive model.
• Check SSD Compatibility: Certain NVMe SSDs (like Samsung PM981 or Micron drives) are notorious for causing write failures and kernel panics under APFS. Check your drive compatibility before proceeding.
• Required Tools: You will need ProperTree to edit your config, and a backup USB drive to boot the installer if things go wrong.

2. Compatibility Snapshot

• Supported configurations: SATA SSDs and compatible NVMe drives (e.g., WD Blue/Black, Crucial P-series).
• Unsupported/Risky hardware: Samsung PM981, PM981a, and PM991 drives should not be used as primary macOS boot drives unless patched, as they cause massive IO bottlenecks.
• Platform distinction: This guide targets desktop and laptop PCs running OpenCore.

3. Installation Preparation

1. USB Port Selection: Always plug your installer USB into a physical USB 2.0 port if possible, or use a USB 2.0 hub. USB 3.0 ports frequently disconnect mid-install without proper mapping.
2. Format target drive: Boot into macOS Recovery, launch Disk Utility, select your target SSD, and erase it as APFS with a GUID Partition Map.
3. Mount EFI: Mount the EFI partition on your installation USB using a helper script or terminal to make necessary adjustments to the bootloader files.

4. EFI and config.plist Review

1. Add NVMeFix: Ensure NVMeFix.kext is present in your EFI/OC/Kexts folder and properly snapshot in your config.plist to optimise power management and compatibility for non-Apple NVMe drives.
2. USB Mapping: Ensure you have an initial USB map or are using `UTBMap.kext` alongside `USBToolBox.kext` to prevent the installer from losing connection to the USB drive during the second stage of installation.
3. Boot Arguments: Add -v keepsyms=1 debug=0x100 to your bootargs under NVRAM to run in verbose mode, allowing you to see exactly where the installer gets stuck.

5. Post-Installation

1. Generate USB Map: Once the system is successfully installed, immediately perform a complete USB mapping to restrict your ports to the macOS limit of 15 and ensure system stability.
2. Move EFI to internal SSD: Mount both the USB and the internal SSD EFI partitions, and copy the working EFI folder from the USB to the SSD.

6. Troubleshooting

Reported Issue: Time increases and installer stalls

1. Stall on USB read: If the time increases and disk activity lights stop blinking, the OS installer has lost access to the USB port. Re-plug the drive into a different port (preferably USB 2.0) and restart.
2. APFS Trim timeouts: By default, macOS tries to trim the entire SSD during installation. For incompatible SSDs, this can take hours. Set SetApfsTrimTimeout to 0 (or 999 depending on OpenCore version) in config.plist -> Kernel -> Scheme to disable Trim during setup.

7. Dual Boot and Advanced Configuration

• Separate Disks: Always install macOS on a separate physical SSD from Windows or Linux to avoid bootloader conflicts.
• OpenCore Priority: Configure your UEFI BIOS to boot OpenCore as the primary option, and use the OpenCore picker to boot into Windows or Linux.

8. Verification, Maintenance and Rollback

• Verify Trim status: After booting, go to System Information -> NVMExpress to verify if Trim is enabled.
• Rollback plan: Keep a working EFI backup on a FAT32-formatted USB drive at all times to allow booting even if you corrupt the internal ESP.

9. References and Glossary

• EFI: Extensible Firmware Interface, the boot partition.
• Kext: Kernel Extension, a driver for macOS.
• Trim: An SSD management command that can cause stalls during boot and install.