ACADEMY

MINING EDITION

MODULE 3

LESSON 5

Troubleshooting Advanced Mining Issues

Even experienced miners encounter issues. This final lesson covers common advanced problems and how to solve them, so you can keep your Qubic mining operation running smoothly.

Authentication Failed / Access Token Errors

If your miner’s log or console shows an error like “ERROR AUTHENTICATION FAILED”, it means the pool rejected your token or address . This can happen if your access token expired or was revoked, or if you mistyped your wallet address. Solution: If you’re using an access token (for a Qubic.li account), log into the pool website and generate a new token, then update your miner config . If you’re mining with just a wallet address (no login), double-check that the address is correct and corresponds to an actual Qubic wallet (addresses start with qubic_...). Also check your internet connection – occasionally a connection issue can cause auth errors if the miner can’t reach the pool reliably . Once corrected, restart the miner.

GPU Not Engaging (or GPU errors)

If you have a GPU but notice it’s not being utilized (e.g., no speedup over CPU-only, or an error loading CUDA/OpenCL), check drivers and OS support.

Transition note: GPU troubleshooting is temporary;.

AMD GPU not mining

Availability of AMD GPU trainers can vary by epoch. Transition note: 

Mining Slows Down Unexpectedly

Investigate thermal throttling, power plans/governors, background processes, or other software using resources. Keep rigs clean and headless where possible.

Miner Crashes or Exits

Check the log/ folder for errors. Reduce threads if memory pressure is high, or set a more compatible cpuVersion (e.g., AVX2) if you forced an unsupported path. Ensure dependencies (.NET runtime, VC++ redists) are installed. If needed, reset appsettings.json and re-download trainers.

“AVX not working” issue

If your CPU supports AVX2/AVX-512 but the miner isn’t using it, override with “cpuVersion” in appsettings.json and restart. Target AVX-512 for long-term compliance.

Idle but No XMR Mining

If you disabled XMR fallback, idle periods won’t earn. If unintended, ensure xmrSettings.disable is false and firewall allows the XMR connection. Note: Fallback switching is built-in; external scripts are not required.

Strange Hashrate or score reporting

Pool UIs can lag. Restart miner/system if needed and check community updates.

Joining the Community for Help

Share hardware, OS, miner version, and logs in the Discord mining channel for rapid triage.

PRO TIP

Keep an eye on your miner during epoch transitions (Wednesdays at 12:00 UTC when a new epoch starts and rewards are paid ). The network may update the AI model or Computor list then. The QLI client typically handles this seamlessly by downloading new data, but it’s not a bad idea to watch the log around that time. If your miner fails to pick up the new epoch’s work (for example, if it gets stuck or spams errors after an epoch change), a quick manual restart can kick it into gear with the fresh parameters.

PRO TIP

Maintain a small maintenance checklist: e.g., reboot your rig once a week (perhaps right after the weekly payout) to clear out any memory leaks or hung threads, check for miner software updates bi-weekly, vacuum dust filters monthly, etc. Preventative maintenance can preempt many issues before they cause downtime.

PRO TIP

Maintain a small maintenance checklist: e.g., reboot your rig once a week (perhaps right after the weekly payout) to clear out any memory leaks or hung threads, check for miner software updates bi-weekly, vacuum dust filters monthly, etc. Preventative maintenance can preempt many issues before they cause downtime.

With these lessons, you now have a comprehensive understanding of advanced mining mechanics in Qubic. You know how uPoW makes your work useful, how to fine-tune your hardware and software for maximum performance, ways to configure the miner to your liking, strategies to keep the network secure & decentralized, and how to troubleshoot like a pro. Qubic’s mining is truly a blend of blockchain tech and AI research – and as an advanced Qubic Academy graduate, you’re at the forefront of this revolution in mining! Happy mining, and see you on the leaderboards.

PRO TIP

Keep an eye on your miner during epoch transitions (Wednesdays at 12:00 UTC when a new epoch starts and rewards are paid ). The network may update the AI model or Computor list then. The QLI client typically handles this seamlessly by downloading new data, but it’s not a bad idea to watch the log around that time. If your miner fails to pick up the new epoch’s work (for example, if it gets stuck or spams errors after an epoch change), a quick manual restart can kick it into gear with the fresh parameters.

© 2025 Qubic.

Qubic is a decentralized, open-source network for experimental technology. Nothing on this site should be construed as investment, legal, or financial advice. Qubic does not offer securities, and participation in the network may involve risks. Users are responsible for complying with local regulations. Please consult legal and financial professionals before engaging with the platform.

© 2025 Qubic.

Qubic is a decentralized, open-source network for experimental technology. Nothing on this site should be construed as investment, legal, or financial advice. Qubic does not offer securities, and participation in the network may involve risks. Users are responsible for complying with local regulations. Please consult legal and financial professionals before engaging with the platform.