Why does XMRig say "huge pages unavailable"?

XMRig says “huge pages unavailable” when it cannot use your operating system’s larger memory pages. Mining usually still works, but it may run slower because your CPU has more work to do when looking up data in memory.

What the message means

Your operating system divides memory into small pieces called pages. Huge pages are larger pieces that let software manage large amounts of memory with fewer lookups.

Monero’s mining algorithm, RandomX, repeatedly accesses memory while your CPU works. Huge pages can reduce the overhead of those accesses and improve your hashrate, which is the number of mining calculations your computer performs each second.

The warning does not usually mean that:

• Your CPU cannot mine Monero.
• Your wallet address is wrong.
• Your mining pool is offline.
• XMRig has stopped mining.

It points to a local memory setting or allocation problem. It is also separate from whether your computer has enough memory overall.

Why huge pages are unavailable

The exact reason depends on your operating system, but these are the common causes:

• Missing permission: Your account is not allowed to allocate huge pages.
• No reserved pages: On Linux, the system may not have set aside enough memory for them.
• Fragmented memory: Free memory exists, but it is scattered rather than available in the large, continuous blocks required.
• Restricted environment: A container, virtual machine, or managed computer may prevent access.
• Disabled configuration: XMRig’s huge-pages setting may be turned off.
• Unsupported operating system: XMRig does not support huge pages on every platform.

RandomX’s fast mode uses a dataset of about 2,080 MB, plus other working memory. Having that much free RAM does not automatically guarantee that huge-page allocation will succeed.

What you can do on your system

On Windows: If you trust your XMRig download, run it as administrator once so it can attempt to enable the Lock pages in memory permission. Restart Windows afterward, then launch XMRig again. On a managed computer, an administrator’s policy may block this change.

On Linux: Huge pages generally need to be reserved and accessible to the account running XMRig. XMRig can attempt automatic setup when run with root permissions, but you should not keep a miner running as root unnecessarily. A better long-term setup is to reserve enough huge pages through your system settings and run XMRig under an ordinary account with the required access.

If allocation fails after your computer has been running for a while, a restart may help by reducing memory fragmentation. Closing memory-heavy applications can also help.

On macOS: XMRig does not support huge pages. Administrator permissions will not fix that limitation.

How to check whether it worked

Look at XMRig’s startup output after RandomX finishes initializing. Check the actual huge-page allocation percentage, not just whether support is listed as available.

• 100% allocation: The relevant memory was successfully allocated using huge pages.
• Partial allocation or 0%: Some or all of it fell back to ordinary pages.

On Linux, optional 1 GB pages are a separate feature. Seeing those disabled does not mean ordinary huge-page support has failed.

Avoid downloading “huge-page fix” tools from strangers. This is a system configuration issue, not something that requires an unknown patch.

The bottom line

You can usually keep mining despite this warning. Check your operating system’s support, permissions, and memory allocation first, then use XMRig’s allocation report to confirm the result.