Boot Flags for Hackintosh

The downside of having a Hackintosh is that when things go horribly wrong, you must fix it yourself. In this guide, I will attempt to go through the basic process to go through when your Hackintosh isn’t functioning as it should.

Your bootloader, be it Clover, Chameleon or Chimera, will have certain flags or special instructions that tell it how to properly boot the computer. In this section, I will go over some common boot flags and their uses.

If your computer hangs on a specific line of the verbose output, you can Google that line for more information about it. If you are asking for help because your computer will not boot, it is good practice to take a picture of your verbose output and post it along with your question.

1 -v | Verbose Mode

This flag will cause your computer to boot in verbose mode. It will print information to the screen as it boots up, rather than displaying the apple logo. This is the go-to method for determining why your computer hangs at the apple logo, and many advanced users prefer to boot this way normally.

2 -x | Safe Mode

If you have experience with Windows, then you’ll already know more or less what safe mode is. It boots your computer with only the essential drivers (kexts) required for the computer to work. This is useful for 2 main reasons. First, if your computer does not boot up in verbose mode and you cannot figure out why safe mode can deduce whether or not it is an issue with your computer’s core functions. Secondly, safe mode can be useful for recovery purposes. If you install a kext that breaks your system, you can boot into safe mode and remove it. If you are having issues booting your computer, you should generally try safe mode just to see if it works, and because debugging a running computer is a lot easier.

3 darkwake=0

This flag disables an advanced power management feature of OS X, which allows some parts of the computer to wake from sleep, but this can mess up sleep on Hackintoshes. Try this flag if your computer cannot sleep, or cannot wake from sleep. Alternatively, darkwake=1 can enable the feature. Note: your computer must be able to sleep through a DSDT or native means before this will make any difference.

4 PCIRootUID=1/ PCIRootUID=0

This flag can help fix hangs at boot. PCIRootUID=0 generally is needed if you’re using an AMD graphics card. Note: this flag solves issues related to graphics cards so you may have to use it upon initial installation or after changing GPUs.

5 npci=0x3000/npci=0x2000

If your computer hangs around the line [PCI Configuration Begin], try both of these flags. 0x3000 is the standard fix, but 0x2000 can be tried if the first option fails to solve the issue.

6 dart=0

This disables some older visualization technology, VT-d. This can fix some motherboard issues, and will not inhibit applications like Virtualbox or Parallels as these applications use VT-x instead.

7 cpus=1

This flag can be used to boot with only a single core of your processor. It can be useful for getting some unsupported cpus to boot the installer. you may need this in a HP laptop with insyde Bios.

8 arch=i386 / x86_64

These flags boot your computer into 32-bit mode (i386) and 64-bit (x86-64), the default for 10.6+ This mode may help with compatibility on some older computers.

9 GraphicsEnabler=Yes/No

This kext enables many partially supported graphics cards through injection. It is not needed for 7xx and 6xx Nvidia graphics cards, but most others will need it too.

10 IGPEnabler=Yes/No

This is an alternative to Graphics enabler. It can be used if you wish to use integrated graphics in conjunction with an Nvidia 6xx or 7xx card.

11 UseKernelCache=No/Yes (10.8+)

The kernel cache is disabled by default, but can be used to speed up boot times by loading your kexts from a cache. If this doesn’t work properly, OS X can boot extremely slowly. Note: for before 10.8 (lion) use -f

You might also like
Leave A Reply

Your email address will not be published.

  1. Loakinto

    When I try to install Niresh-Mojave on my laptop after almost installing the MacOs up to 80% gives the error “An error occurred while running scripts from the package “Clover UEFI.pkg”

    How do I fix this?

    1. macOS

      You have to partition your hard disk under GUID Partition table.

  2. Ricardo Santos

    Hello. I type in a boot flag “amd64”. When I run that in Mac OS Mavericks. It’s stuck on an Apple screen with the message “tsc_init: EFI not supported!”

    How to fix?

    1. macOS

      You must post your full hardware specs, Link a picture if possible.

  3. bryan

    key board and mouse wont work
    how do i fix that

    1. macOS

      Is that a laptop? You might need additional kexts like VoodooPS2Controller.

  4. Adithyan

    Installation is successful and after selecting country and selecting keyboard layout will reboot automatically and how can I solve this

    1. macOS

      Could you boot in verbose and post a screenshot or kernel panic.

  5. Lakshamana

    Hello, my bootloader stucks on [PCI Configuration Begin] and I’ve tried a lot of boot flags. None of them seemed to work, so it still hangs in there. Note I do not have any visible CFG-lock related configuration on my Gigabyte b360m Aorus Gaming 3 motherboard. My graphics card is a a Galax GTX 1050 Ti.

    1. Hackintosh Shop

      What about npci=0x3000?

  6. Nasir khan

    installed KEXT from hackintool for wifi solution (because wifi was not showing up) then I restarted and now it’s in boot loop. Can u help me fix it? I tried to select safe mode but it is not booting in safe mode too.

    1. Hackintosh Shop

      You need to manually remove the kext, Is it installed in EFI or /S/L/E?
      If it is /S/L/E you can try to remove it in Single User mode.

  7. Jitzz

    Failed to Set MokListRT: Invalid Parameter
    Could not create mokListRT: Invalid Parameter
    Importing MOK states has failed: import_mok_state() failed: Invalid Parameter
    Continuing boot since secure mode is disabled

    This msg show after installation complete

    1. Hackintosh Shop

      This is irrelevant to Boot-flags, Looks like Hackintosh Bootloader is not Installed properly.

  8. neomi

    This one´s really helpfull… Thx a lot!

  9. Du54nR

    Does anyone know how to start/boot on Intel NUC8i3BEH device ? I have allso try with -x boot flag only and it does not start

    1. Hackintosh Shop

      Please post in the forum, With verbose more and full hardware specs.