Many Whatsminers only allow read access to their API by default. Foreman can monitor them, but can't send commands such as reboots, pool changes, power mode changes, static IPs, password changes, factory resets or LED blinking. This article shows how to turn on the write API with Whatsminer's own tool.
When You Need This
- Remote commands to a Whatsminer fail with Write API must be enabled, or with Firmware is outdated or has a bad password.
- Your Whatsminers run firmware newer than 20200801. We recommend 20211116 or later. Remote management of older firmware is only minimally supported.
Before You Start
- Use a Windows computer on the same network as the miners.
- Download the latest Whatsminer Tool from the Tools and documentation section of Whatsminer's firmware page.
- Know the miners' current username and password. The factory default is admin / admin.
Steps
- Extract and run the Whatsminer Tool.
- Click Miner IP, enter the IP range of your miners, and make sure the range is selected in the bottom box.
- Click Monitor and wait until the Total and Scanned counts at the bottom match. Then select the All checkbox.
- Change the miner password. The tool won't enable the API until the password has been changed. You can change it to a new password, or "change" it from admin / admin to admin / admin.
- Click Remote Ctrl, choose Miner API Switch, click Ok, choose Enable, and click Ok.
- Change the password again, the same way as in step 4. This is needed for the setting to stick.
What You Should See
Send a test command from Foreman, such as Blink LEDs, to one miner. It should show as Complete. If you changed the password, update it on the miner in Foreman (the miner's Settings), or with Bulk Edit Miners for many miners.
Related Articles
Last verified: November 19, 2026