There are two supported ways to flash new firmware onto a Canaan AvalonMiner: a single-machine upgrade through the miner’s own web interface, and a batch upgrade across a whole fleet using Canaan’s management tooling. Which path you take depends on how many units you run — but the discipline is the same either way: match the firmware to the exact model, keep power stable through the entire write, and verify the result before you walk away. Get any of those wrong and you turn a five-minute update into a bench-repair job.
Looking for the full, model-by-model update walkthrough? See our Avalon firmware update guide for every stock update path across the Nano 3, Nano 3S, Mini 3, Avalon Q and the K210 industrial line, with default IPs, credentials and recovery procedures for each.
Can You Run Third-Party Firmware on an AvalonMiner?
No aftermarket firmware vendor supports Canaan’s K230 home line — the Avalon Nano 3, Nano 3S, Mini 3 and Avalon Q. Braiins OS+, VNish and LuxOS are Antminer-only; Hiveon builds no custom firmware for any Avalon either — its custom-firmware list names no Canaan hardware, and it can only monitor/manage some older industrial Avalons through its ASIC Hub on Canaan’s own stock firmware. So for the home units there is no aftermarket firmware to swap to — the firmware-swap playbook from the Antminer world has no equivalent there.
What has appeared instead is a small open-source and community firmware scene on Canaan’s approachable K230 home platform — a Nano 3 jailbreak that bypasses the signed-update check, a community custom firmware for the Mini 3, and a GPL-3.0 project (DCENT_OS) in active development. These are described, credited and caveated — not prescribed as a D-Central procedure — in our Avalon custom firmware landscape guide. So the precise answer is: no aftermarket vendor supports the K230 home line, but an emerging community/open-source K230 firmware scene exists, and D-Central is building the only GPL-3.0 entrant.
It is also worth crediting what Canaan ships. It publishes firmware source — the open Avalon_Nano3s layer for the home line, and Avalon_mm for the K230 industrial platform — and its version strings bind to a git commit (Avalon_Nano3s_2025012122_b377540), a materially better provenance story than either Bitmain or MicroBT offers. Canaan also supplies a first-party tuning path through its Privileged API tier, about which the vendor states plainly: “Using Privileged API will cause the warranty invalid.”
Before You Flash: Get the Right File
AvalonMiner firmware is not interchangeable between models or hardware generations. Downloading “the latest firmware” and pushing it to the wrong board is the single most common way owners brick a unit. Sort this out first.
- Identify the exact model and hardware generation. Industrial K210 units (the A1246–A1566 line) run Canaan’s Module-Manager firmware paired with a CGMiner build and take an
.aupupgrade package. The K230 home line (Nano 3/3S, Mini 3, Avalon Q) ships signed.swu/.kdimgimages with RSA verification — a signed image cannot be swapped onto a different model, and tampered or downgraded images are rejected. Grab the file that names your model. - Download only from Canaan: the official firmware portal at canaan.io/support/file_download (select your model series), or the support knowledge base at support.canaan.io. Do not flash random firmware pulled from forums.
- Record your current pool configuration and firmware version. Note the pool URLs, worker names, and the version string before you touch anything — an upgrade can reset settings, and you want a known-good baseline to compare against.
- Stabilise the environment. Flash over a wired connection where possible, on a machine that will not drop the miner mid-write. A dropped link or a power blip during the write is what corrupts the image.
Method 1: Single-Machine Upgrade via the Web Interface
Best for one or a handful of units. The AvalonMiner serves its control panel on port 80.
- Find the miner’s IP address (from your router’s DHCP table, or by pressing the unit’s IP-report button if fitted) and type it into a browser on the same network. Home units default to
192.168.168.168. - Log in. On the Nano 3 the factory credentials are
root/root; the Nano 3S usesadmin/adminand forces a password change on first login. If you changed them, use yours. - Open the Upgrade page. On older builds this is a direct “Upgrade” link; on the newer backend it lives under the system/maintenance menu.
- Click Browse, choose the firmware file you downloaded, and click Upload.
- Let it run. The miner writes the image and reboots on its own. Do not close the page, reload, or cut power until it reports success and comes back online — interrupting the write is how units get bricked.
Method 2: Batch Upgrade Across a Fleet
When you are running rows of AvalonMiners, flashing them one browser tab at a time does not scale. Canaan’s fleet tooling pushes the same image to many units at once over the CGMiner API on port 4028.
Use whichever current tool Canaan links from the support portal for your generation — the AvalonMiner app and desktop Upgrade Tool for the modern line; the AvalonMiner Upgrade Tool network reflash for the K210 industrial units. The workflow is consistent:
- Download the correct firmware package from Canaan’s support page.
- Launch the management tool and let it discover the miners on your subnet.
- Select the units to upgrade — confirm they are all the same model, since one image will be pushed to every selected machine.
- Point the tool at the firmware file and start the upgrade.
- Watch the report. On completion you get a success confirmation; any units that failed are listed by IP so you can retry them individually rather than re-running the whole batch.
Verify the Upgrade Worked
A reboot is not proof of success. Confirm the miner actually took the new image and is hashing clean:
- Check the reported firmware version. In the web UI it appears on the status/overview page. From a terminal you can query the CGMiner API directly:
echo '{"command":"version"}' | nc <miner-ip> 4028returns the running MM and CGMiner version strings. - Confirm all hash boards are detected and the accepted hashrate has climbed back to the model’s nominal figure — a board that dropped out after the flash points to a bad write or a pre-existing fault the reboot exposed.
- Reapply and confirm your pool settings. If the upgrade reset them, re-enter the pool URLs and worker names you recorded earlier, and watch for accepted shares.
- Watch temperatures and fan behaviour for the first few minutes to be sure the thermal control loaded correctly.
Common Mistakes and Recovery
- Wrong firmware for the model. The number-one brick cause. Double-check the filename against your exact model before uploading.
- Power or network loss mid-write. Never flash a unit you are about to move, and never share the circuit with something that might trip during the write.
- Trying to downgrade a signed home unit. The Nano series’ signature check will refuse older or unsigned images — that is by design, not a fault.
- Assuming a lost pool means lost firmware. If a unit stops hashing after the reboot, check pool config and board detection before you re-flash — most “failed upgrades” are just wiped settings.
If a unit will not boot after a flash, re-upload the correct firmware through the web interface or the batch tool; a partial write can usually be recovered by simply flashing again cleanly. On a K230 home unit that cannot be reached at all, use the K230 BurningTool recovery path (pinhole button + double-male USB-A) documented in our Avalon firmware update guide. If the control panel is unreachable and the miner shows no network, it has likely failed the write hard and needs hands-on recovery or a hardware inspection rather than another blind flash attempt.
Related: Keep the matching model documentation on hand from our AvalonMiner manuals library, run a structured diagnosis with the ASIC fault finder if a board drops out after upgrading, brush up on the terminology in our firmware glossary entry, and if a unit is bricked or a hash board is dead, start a repair with D-Central rather than risking further damage.
