Common Troubleshooting: Remote Command Errors

Updated

Use this page when a remote command, such as a reboot, pool change, power mode change, password change, static IP, LED blink, firmware upgrade or factory reset, doesn't complete. Find the message Foreman shows and follow the fix.

Where to see command results: the commands panel at the top right of Foreman, and the Pickaxe Command History section on the miner's details page. Successful commands show as Complete.

Command progress shown at the top right of the dashboard

Command Errors

Message Likely cause Fix
Miner is unreachable
ConnectionTimeoutExceeded: connect timed out
Miner didn't respond
Pickaxe can't connect to the miner on the network. Check that the miner is powered on and connected. Check that its IP address in Foreman is correct (a recurring re-sync keeps IPs current). On a VPN or slow network, increase the socket read and write timeouts in the Pickaxe's Configure settings.
Failed to obtain a response from <ip>:<port> The miner connected but didn't answer the command. Check the miner is working, and that its IP address, username and password in Foreman are correct. On a slow network, increase the Pickaxe timeouts.
Failed to log in The username or password stored in Foreman doesn't match the miner. Update the credentials in the miner's Settings on the Miners page, or for many miners with Bulk Edit. Foreman doesn't need factory-default passwords, but they must match what's on the miner.
Dispatch timed out Pickaxe didn't pick up the command within 3 minutes, usually because its computer is overloaded. Restart the Pickaxe. Keep its CPU use under about 50%: move it to a more powerful machine, give its VM more threads, or split miners across more Pickaxes. See Quick Guide: Hardware Requirements.
Write API must be enabled The Whatsminer's API is read-only. Turn on the write API. See How To: Enable The Write API On Whatsminers.
Firmware is outdated or has a bad password The Whatsminer's firmware is too old, or the credentials are wrong. Check the credentials in Foreman. Update the firmware to at least 202009 (20211116 or later recommended).

Other Things to Check

  • Is the command supported? Only the commands a model supports appear in its menus. Check Support > Supported Miners in Foreman.
  • Is a dispatch active? Trigger actions that send commands to miners are skipped during an active demand response dispatch.
  • Older Avalons stuck as Pending need their API opened first. See How To: Open The API On Older Avalon Miners.
  • Miners not updating at all is usually a Pickaxe or network problem. See Common Troubleshooting: Pickaxe.

When to Contact Support

If a command keeps failing after these checks, contact Support with the miner ID, the command, the exact message, and roughly when you sent it.

Last verified: November 19, 2026

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Can't find what you're looking for?

Our support team can help with setup, hardware and billing questions.

Contact Support