Bitaxe Gamma firmware update v2.15.4: how to do it right

Updated on 1 November 2026 for AxeOS v2.15.4.

AxeOS v2.15.4 has been the stable firmware for the Bitaxe Gamma since 21 October 2026. The update itself is a matter of uploading one file. A few things have changed since 2.15, though, and you can now cleanly go back if it disappoints. Below you can read step by step how to do the Bitaxe Gamma firmware update.

In short: reset your overclock to the default values (525 MHz and 1150 mV for the Gamma), download esp-miner.bin from the official v2.15.4 release and upload only that file on the Update page in AxeOS. A separate www.bin is no longer needed. Your settings are kept, and via Installed Firmware you can go back to your previous version.

In this article

• What has changed in 2.15?
• Which files do you need?
• The firmware update in five steps
• Back to your previous version
• If something goes wrong
• Frequently asked questions

Which version should you choose, and should you update?

Take the latest stable release. Versions labelled Pre-release and early-access builds are for people who want to help test and report bugs.

• New Bitaxe or a factory reset? Flash the latest stable version.
• Troubled by a bug that has been fixed? Update to the version with that fix.
• Is everything running well? Read the release notes and then decide. There is usually no rush.

What has changed in 2.15?

Since v2.15.1

If you run v2.15.1 without problems, this is not an urgent update. It is about support for new hardware and a small fix:

• v2.15.2 (test version, 18 September): drivers for the BM1372 and BM1373 chips, support for the Naja Duo and Gamma Hex.
• v2.15.4 (stable, 21 October): replaces the built-in list of trusted certificates after certificate issuer eMudhra was compromised.
• v2.15.3 (stable, 20 September): the low-frequency warning now looks at your device's presets. That fixed a false warning on the Naja Duo, which runs at 327 MHz by default. On a regular Gamma you won't notice a thing.

Still on 2.14?

If you're coming from 2.14 or older, the step is bigger. What's different since 2.15:

• One file. The web interface is included in esp-miner.bin. You don't upload a separate www.bin anymore.
• Reachable by name. You can now also open AxeOS via the device name, for example bitaxe.local. The IP address keeps working.
• Going back. The Update page shows your installed firmware versions, so you can switch back.
• Also: multi-line charts, better undervoltage detection, Bluetooth LE, room for more stored pools and improvements to Stratum V2.
• v2.15.1 restored wifi on routers in mixed WPA2/WPA3 mode, showed missing IP addresses again in the Swarm view, and made sure a slow browser with the dashboard open no longer bombards your miner with new connections.

Prefer to see it on screen? WantClue, one of the people helping build the Bitaxe firmware, made the video Bitaxe Update Version 2.15.0 (in English). On the WantClue YouTube channel you can also regularly find the Bitaxe Townhall, which covers the latest Bitaxe news.

You can go straight from 2.14 to v2.15.4: upload the new esp-miner.bin, the firmware includes its own interface. If you want to see what changed in each version, take a look at the releases on GitHub.

Which files do you need?

• esp-miner.bin: the only file for an update via AxeOS. This is the same file for all Bitaxe models.
• Factory files (with factory in the name): only for flashing via USB, for example during recovery. They differ per board version. Never upload them via AxeOS.
• www.bin: only needed if you use a custom web interface, or if you go back to 2.14 or older. Take it from the same release as the firmware then.

The firmware update in five steps

Step 1: check your version and note down your settings

Open AxeOS, the dashboard of your Gamma, in your browser via the IP address on the little screen. Go to the page Update and look at Current Version to see which version you are running. In older versions you find this under Settings.

Write down right away what you see now: hashrate, temperature, your pool details and your bitcoin address, frequency and voltage. Then you can compare after the update, and you have everything at hand if you unexpectedly need to set it up again.

Step 2: reset your overclock

If you have overclocked your Gamma, first set it back to the default values: 525 MHz and 1150 mV. That way you know for sure after the update that any hiccups are not caused by your overclock. After that you can work your way up again step by step.

Step 3: download esp-miner.bin

On the Update page, click Check, next to Latest Release. AxeOS asks whether it may connect to github.com; confirm with Continue. Then download esp-miner.bin from the v2.15.4 release.

If you run 2.10 through 2.15.0, it says in orange there: Download both files for update! That message is outdated: v2.15.4 only comes with esp-miner.bin, and you won't see any more files listed there either.

You can also get the file directly from the official ESP-Miner releases on GitHub. Only use official sources.

Watch the file name. AxeOS only accepts a file that is called exactly esp-miner.bin or else you get the message Incorrect file, looking for esp-miner.bin. If there is still an esp-miner.bin from a previous update in your downloads folder, your browser often saves the new one as esp-miner (1).bin. Delete the old one and give the new one the name esp-miner.bin. Never rename another file, such as a factory file, to esp-miner.bin.

Step 4: upload the firmware in AxeOS

1. On the Update page, click Browse, under Update Firmware.
2. Choose esp-miner.bin.
3. Wait until the upload reaches 100% and AxeOS reports that the firmware has been updated (Firmware updated).
4. The Gamma restarts. Expect about a minute.

Do not cut the power until the dashboard loads again after the restart. AxeOS asks for that during the update as well. If it still goes wrong, your Gamma usually just boots on the old version again, but you don't want to gamble on that.

Step 5: refresh your browser and check

Reload the dashboard without cache: Ctrl+Shift+R on Windows and Linux, Cmd+Shift+R on a Mac. Otherwise you sometimes still see the old interface. Then check:

• next to Current Version does it now say v2.15.4?
• is your pool connected?
• does the hashrate return to its pre-update level within a few minutes?
• does the wifi connection stay stable?

If everything checks out, you can build your overclock back up at ease. If something isn't right, read below how to go back to your previous version and what to do if something goes wrong.

Back to your previous version

Don't like v2.15.4? Since 2.15 you no longer need to flash for that. On the Update page there is the table Installed Firmware. Click Activate next to your previous version and confirm. The Gamma restarts on that version and your settings are kept. That only works if you updated via AxeOS: after flashing via USB there is no previous version in the table anymore.

If something goes wrong

• Dashboard not reachable. Wait two minutes and reload. If the IP address has changed, check the little screen or your router, or try the device name, such as bitaxe.local.
• Dashboard loads but looks broken. Reload without cache. If that doesn't help, open the dashboard in a private window or in another browser.
• The Gamma keeps restarting. Flash the firmware again via USB and enable Keep configuration in the flasher. If that doesn't work, flash without that checkbox (that is a factory reset) and set everything up again.
• The Gamma no longer responds at all. Use recovery mode: remove power and the USB cable, hold the BOOT button, reconnect power and USB and release after about two seconds. Then flash the factory file for your board version.

You can read how to flash via USB in our guide Flash Bitaxe firmware. Use Chrome or Edge on a computer (not a phone), a USB-C cable that carries data, and no USB hub. In the flasher, check Keep configuration if you want to keep your settings. That checkbox is off by default, and without it you wipe your wifi, pool and bitcoin address.

Can't figure it out? Send us a message or ask your question in the OSMU Discord, the community behind the Bitaxe. Include which version you had, which file you uploaded and what you see now.

Frequently asked questions

Will my settings be kept?

Yes, with an update via AxeOS and when flashing via USB with Keep configuration checked. Wifi, pool, bitcoin address, frequency and voltage are kept. Only with a factory reset do you lose everything, and your Gamma starts its own wifi network for setting up again.

Do I still need to upload a www.bin?

No. Since 2.15 the web interface is included in esp-miner.bin. If you still see advice somewhere to also upload a www.bin . That only applies to an update to 2.14 or older.

Can I go directly from 2.14 to v2.15.4?

Yes. Only upload the new esp-miner.bin. Intermediate versions are not needed.

Does this also work for the Gamma Silent, Supra and Low Profile Plus?

For an update via AxeOS you use the same esp-miner.bin. Reset your overclock to the default values for your model; the 525 MHz and 1150 mV in this guide apply to the Gamma. If you flash via USB, choose the factory file for your board version.

How do I update a NerdQaxe++?

That one uses its own firmware with a different approach. A regular update is done in the dashboard under Settings, in Release & Update: choose a version, leave Keep Settings checked and click Install from GitHub. If that doesn't work, or you want to start over, use the browser flasher from our guide Flash NerdQaxe firmware.

Does the update give more hashrate?

Don't count on it. The changes in v2.15.2, v2.15.3 and v2.15.4 are about support for new models and a dashboard warning, not about more hashrate for the Gamma.

I use Stratum V2. Do I need to set anything up again?

No, your pool settings stay in place during an update. You can read how to set up Stratum V2 in the guide Stratum V2 on the Bitaxe.

No Bitaxe yet?

The Bitaxe Gamma is an open-source solo miner of about 1.1 TH/s that you run at home. Not a profit machine: your chance of finding a block yourself is small, but real. And every home miner makes the network a little less dependent on a handful of large pools. Check out the Bitaxe Gamma or all solo miners.