Download checklist
Verify source, version and release notes before running the tool.
WhatsMiner Tool troubleshooting
Use this page when the tool cannot find miners, API operations fail, firmware updates stall or Windows security software blocks scanning.
This is an independent operator guide. Verify current downloads, firmware notes and warranty-sensitive actions on official WhatsMiner support pages before changing production miners.
Common symptoms
Quick diagnosis table
| Symptom | Likely cause | What to check |
|---|---|---|
| No miners found | Wrong subnet or blocked discovery | Check IP range, VPN, Windows Firewall and router segmentation. |
| Auth error | Password mismatch or default credential issue | Update admin password through WhatsMiner Tool and retry. |
| API operation fails | API switch disabled or unsupported firmware | Enable Miner API Switch and verify firmware support. |
| Firmware update fails | Wrong file, model mismatch or rollback restriction | Use correct official .bin file and read release notes. |
| Antivirus warning | Network scanner heuristic or unverified archive | Verify source, scan file and avoid unknown mirrors. |
Recovery sequence
Work from least destructive to most destructive
Refresh scan
Confirm network reachability and rescan the exact range.
Check credentials
Update password records and retry authenticated operations.
Export logs
Save logs before reboot, reset or firmware action.
Escalate carefully
Use factory reset or firmware recovery only after model-specific documentation review.