Open Source Miners Flasher

Free web flasher

AxeOS update for Bitaxe & NerdQaxe, right in your browser

For the NerdQaxe ++, NerdOctaxe, Nerdaxe and Bitaxe: plug in a USB cable, pick the device, install. The flasher reads your miner first, fetches the matching file from the GitHub release and checks it before writing anything. An update keeps Wi-Fi, pool and address in place.

Go to the flasherUpdate without a cable
  • OSM-OS or Original, any version
  • SHA-256 of every file checked against GitHub
  • Detection over USB, read-only
  • Recovery for miners that no longer boot
NerdQaxe ++
NerdOctaxe
Bitaxe Gamma 601

Install firmware

Three choices, then the flasher writes. What usually fits is preselected.

Which miner is on the cable?

Tap your device or let the flasher look it up.

Detect automatically

Keep the power supply connected and run a USB-C cable with data lines from the miner straight to the computer. Detection only looks: which device, which board, which firmware, which Wi-Fi.

Nerd family NerdOS, firmware built per board

Bitaxe AxeOS, one firmware for all boards

Fetching versions from GitHub …

Board not listed? All factory images

This list holds every board from the releases, including ones we do not sell (such as NerdQAxe+, NerdQX or Bitaxe Ultra). The flasher always writes an image from this list as a full factory install. Pick from it only when you are certain of your board name.

Firmware and version

Both channels come from GitHub releases. The newest stable version is preselected.

OSM-OS is our build of ESP-Miner (Bitaxe) and ESP-Miner-NerdQAxePlus (Nerd family). What changes are defaults: hostname OSM-Miner, pool pool.bitaxe.de with pool.opensourceminers.de as the fallback, a preset Bitcoin address (replace it with your own after a factory install), and the clock of some boards. On top there is an OSM-OS update channel in the web interface. The source code is public on GitHub.

Files only pass through our server, nothing is altered. Before writing, the flasher compares every file by SHA-256 with the value in the GitHub release; files without a checksum are never offered.

Update or factory install?

For a miner that runs, the update is almost always enough.

No miner selected yet Tap your miner above, or connect it and press Detect over USB.

No Chrome on a computer? Update through the web interface

Phones, tablets, Safari and Firefox have no Web Serial. You can still update, through the miner’s web interface on the same Wi-Fi, and the settings stay in place.

Bitaxe with OSM-OS

One-click update

From OSM-OS v2.15.3 the Update page in AxeOS finds the newest OSM-OS version by itself: tap Check, then Install. The version list comes from GitHub, the file through this flasher.

Nerd devices with OSM-OS

Update from Settings

NerdOS has an update area under Settings with the OSM channel, the official releases and a One Click Update. The miner downloads the file from GitHub on its own.

Any firmware

Upload the files

Pick your miner above. In a browser without Web Serial the flasher shows download buttons for exactly the files your device needs: esp-miner.bin for a Bitaxe, the board’s own app file plus www.bin for the Nerd family.

AxeOS: open the Update page NerdOS: open Settings

The miner’s display shows the address. The link stays inside your own network; our server never sees it.

Bitaxe and Nerd devices in one swarm

Plenty of homes run more than one miner, say a Bitaxe Gamma on the desk and a NerdQaxe ++ on the shelf. The flasher handles that fine, one device at a time.

The two families come from separate firmware projects. Bitaxe devices share a single app file and keep the board in their settings. In the Nerd family each file is built for exactly one board; a NerdQaxe ++ file does not run properly on a NerdOctaxe. That is why the flasher reads which firmware a device runs before every write and blocks an update that does not fit.

With several devices the routine is: plug in, detect, install. On the success page choose “Flash the next miner”, move the cable, detect again. Channel and install type stay as you set them.

One tip to keep track: every OSM-OS device ships with the hostname OSM-Miner. Give each one its own hostname in the settings and you will find them in your router and under http://name.local.

NerdQaxe ++4× BM1370, NerdOSNerdOctaxe and Hydro8× BM1370, NerdOSNerdaxe Gaia and Copper ProBM1373, own releasesNerdaxe GammaBM1370, NerdOS

Which file belongs to which device

This is how the flasher maps the firmware. Factory images carry the board name in the file name; update files go where the app lives.

DeviceChipFactory imageUpdateMore
NerdQaxe ++4× BM1370NerdQAxe++esp-miner-NerdQAxe++.bin + www.binFirmware page
NerdOctaxe8× BM1370NerdOCTAXE-Gammaesp-miner-NerdOCTAXE-Gamma.bin + www.binFirmware page
NerdOctaxe Hydro8× BM1370NerdOCTAXE-Gammaesp-miner-NerdOCTAXE-Gamma.bin + www.binFirmware page
Nerdaxe GaiaBM1373NerdAxeGaiaesp-miner-NerdAxeGaia.bin + www.binFirmware page
Nerdaxe Gaia Copper ProBM1373NerdAxeGaiaProesp-miner-NerdAxeGaiaPro.bin + www.binFirmware page
Nerdaxe GammaBM1370NerdAxeGammaesp-miner-NerdAxeGamma.bin + www.binFirmware page
Bitaxe Gamma 601BM1370601esp-miner.binin the shop
Bitaxe Gamma Copper ProBM1370copperzilla (OSM-OS), 601 (Original)esp-miner.binin the shop
Bitaxe GT 8012× BM1370801esp-miner.binin the shop
Bitaxe Supra Hex 7026× BM1368702esp-miner.binin the shop
Bitaxe Gamma Hex 13006× BM13701300esp-miner.binin the shop

Devices with closed firmware such as the Avalon Nano 3S are not supported. Other boards from the releases, for example NerdQAxe+, NerdQX or Bitaxe Ultra, are under “All factory images” in the flasher.

What happens during an install

The progress view lists every step on its own. Nothing is written until download, checksum and device all line up.

  1. DownloadThe files come from the GitHub release, routed through our server because GitHub sends no CORS headers for release files.
  2. Compare SHA-256Your browser computes each file’s checksum and compares it with the value in the release. Any mismatch stops the process.
  3. ConnectOver Web Serial the browser talks to the ESP32-S3 inside the miner. You confirm the port yourself in the browser window.
  4. Read and checkPartition table, running firmware and settings are read. If your choice does not fit the device, the flasher asks or blocks the update.
  5. EraseFactory install only: the whole flash is wiped.
  6. WriteAn update puts app and web interface at their addresses, clears the boot selection (otadata) and leaves the settings area (NVS from 0x9000) alone. A factory install writes the full image from 0x0.
  7. Verifyesptool-js has the chip compute an MD5 over what was written and compares it with the file.
  8. RestartThe flasher resets the miner, which boots into the new firmware.

Miner stuck or dark?

If a miner is stuck in a boot loop, the display stays dark or no port shows up on the computer, flash mode helps. Powered on with the BOOT button held, the chip accepts new firmware even when the old one is broken.

Questions about firmware updates

Which firmware version is my miner running?

Connect the miner over USB and click “Detect over USB”. The flasher shows the installed version and whether a newer one exists. Without a cable, look in the web interface: the System page in AxeOS, or the update area under Settings in NerdOS.

Do I have to set everything up again after an update?

No. An update only writes firmware and web interface. Wi-Fi, pool, address and tuning live in a separate flash area (NVS) that the update never touches. Only a factory install means setting things up again.

How does OSM-OS differ from the original firmware?

OSM-OS is our build of ESP-Miner and ESP-Miner-NerdQAxePlus with our own defaults: hostname OSM-Miner, pool.bitaxe.de as pool, pool.opensourceminers.de as fallback, a preset Bitcoin address that you replace with your own after a factory install, adjusted clock on some boards and an OSM-OS update channel in the web interface. Original means the unmodified releases by bitaxeorg and shufps. Both are GPLv3 and public on GitHub.

Where do I find esp-miner.bin and www.bin?

In the projects’ GitHub releases. The easier way is right here: pick your miner, and a browser without Web Serial shows download buttons for exactly the files your device needs. With Chrome, Edge or Opera on a computer you do not need the files at all, because the flasher writes them itself.

Can I flash from a phone or tablet?

Not over a USB cable; for that the flasher supports Chrome, Edge and Opera on a computer only. On a phone, use the miner’s web interface for the update, as described in the section on updating through the web interface.

The flasher finds no port. What now?

Usually it is the cable: many USB-C cables only charge and carry no data. Plug straight into the computer rather than a hub or monitor, and close other tabs or programs using the port. If that does not help, start the miner in recovery mode with the BOOT button held.

The miner does not restart after flashing.

Some USB ports do not pass the reset signal through. Unplug the power supply briefly and plug it back in. If the display stays dark after that, repeat the install as a factory install.

Can I go back to an older version?

Yes. The version field lists the releases of the chosen channel with the newest stable one preselected, and the flasher writes an older one the same way. If the miner does not start cleanly after going back, use the factory install.

What does the flasher read from my miner, and where does it go?

The partition table, the header of the running firmware and settings such as hostname, Wi-Fi name, pool and user. All of it stays in your browser and is sent nowhere. The flasher never displays the Wi-Fi password. This page uses no tracking and no cookies.