How to Update ASIC Miner Firmware: File Checks, Settings, and Recovery
Match the firmware package to your ASIC, choose which settings to keep, and verify one attended update before expanding the rollout.

Update an ASIC miner's firmware with the official package for its exact hardware, a saved configuration record, and the manufacturer's matching procedure. Decide whether settings should survive before uploading, maintain power through the documented process, and check both the installed version and the intended pool worker afterward. If file compatibility, signature requirements, or recovery options are unclear, resolve those gaps before starting with one attended miner.
Start with the reason for this update
Write down what the new firmware is supposed to change: a documented fault, a security issue, or a feature you actually need. Save the release description beside the current version. That gives the update a testable purpose instead of turning a newer filename into a promise of better mining.
This workflow covers a planned update on a reachable miner. A unit that will not boot, repeatedly loses power, or shows a physical fault needs the matching diagnostic or recovery procedure first. Firmware cannot repair a failed fan or damaged connector. Replacing the software while changing the pool, network and power mode also makes any improvement difficult to explain.
Keep the initial operating settings comparable where the release permits it. If an update intentionally changes available modes or defaults, record that difference before comparing results.
Match the package to the machine before uploading
Use the manufacturer's official support route and read the download description. A filename containing the right family name is only the beginning of the check. Confirm any subtype, control-board, current-version or installation-method conditions that the release lists.
Bitmain's firmware download instructions direct users to select the corresponding model and read the firmware type and description. They also say its normal web or batch update download does not need decompression. A recovery package may have different preparation instructions; keep those workflows separate.
| Check | Record before proceeding | Hold the update when |
|---|---|---|
| Physical identity | Exact product name, serial or asset label, and relevant board revision | The interface, label and download description disagree |
| Current software | Installed version and any third-party firmware already present | The required starting version or migration path is unknown |
| Target package | Official source, complete filename, release description and applicable hardware | The file comes only from a repost or merely similar model |
| Installation method | Normal web update, fleet-tool update, or recovery procedure | The selected file belongs to a different method |
| Configuration behavior | What stays, what resets, and how access will be restored | Losing the address or pool settings would leave no local recovery path |
| Recovery boundary | Vendor-supported next step if the update fails | The plan depends on an unconfirmed downgrade |
A saved old firmware file does not establish rollback support. Bitmain's security firmware Q&A documents releases that disable SSH access and prevent returning to the previous version. Those are examples of release-specific restrictions, not a compatibility list for every current miner. Check the exact transition you intend to make, including any management-tool access it may remove.
If the publisher provides a checksum or signature-verification method, use it as directed. A checksum you calculate yourself can identify your saved file later; by itself it does not prove that the file came from the manufacturer.
Save a baseline that survives the upgrade
Keep a readable record of the network assignment, primary and backup pool endpoints, worker identity, operating mode, firmware version and management access. Export configuration if the interface supports it, but do not rely on an export as the only recovery record. Its format may not suit the next release.
Capture the current board status, averaged local hashrate, fan and temperature readings, and the intended pool worker's accepted-work history over a noted interval. Record the relevant inlet conditions and power mode so the comparison has context. Store credentials securely outside this worksheet.
Save complete logs before the update can replace them. The miner log capture guide explains how to retain the event window, clock basis and surrounding symptoms. That matters especially when the update is meant to fix an intermittent fault: a clean screen after reboot is weak evidence without the earlier failure record.
Make the keep-settings choice deliberately
For the interface covered by Bitmain's online upgrade tutorial, the operator opens the firmware-upgrade page under System, selects the file, confirms the filename, and starts the upgrade. Its configuration checkbox controls whether pool and network settings remain; clearing it restores those settings to defaults and can change the miner's IP address.
Use that as a documented Antminer example. Other firmware and brands may expose different controls. Before pressing the final button, state which outcome you expect: retained settings, or cleared settings followed by a prepared configuration process. Keeping an unknown or faulty configuration is not automatically the safer option.
Arrange an attended maintenance window with stable power and a local access route. Follow the exact procedure's power, completion and reboot instructions. Do not interrupt power because a browser page stopped refreshing, and do not borrow a waiting time from another model's tutorial. The upload, reboot and return to useful mining are separate stages.
After the documented restart, rediscover the address if necessary. Read the installed version from the returned interface and compare it with the target release before changing anything else. Verify the chosen settings behavior instead of assuming the checkbox preserved every setting you care about.
Accept the first upgraded miner before expanding the rollout
Start with one miner that can be watched and recovered locally. Bitmain's firmware update tips recommend a limited initial deployment because release testing cannot reproduce every mining environment. For a small operator, the useful principle is to learn from an attended first unit before exposing the rest of the operation to the same change.
Fill in this acceptance record with observations, not checkmarks based only on an upload-success message.
| Acceptance item | Evidence after the update | Decision |
|---|---|---|
| Installed release | Version shown by the intended physical miner | Stop rollout if it differs from the target |
| Configuration and access | Expected network, pool, worker, credentials and supported management functions | Correct a known setting; investigate any unexplained change |
| Initialization | Expected boards detected; fans, temperatures and local averages settle as documented | Keep the unit attended if faults recur |
| Useful work | The intended pool account shows the correct worker submitting accepted work | Do not accept a connected-but-idle worker |
| Original update reason | The specific fault or feature is checked under relevant operating conditions | Record unresolved symptoms instead of calling the update a fix |
| Operational handover | New version, configuration changes, observations and recovery instructions saved | Expand only when the result and recovery boundary are understood |
Choose an observation period that covers initialization, the pool's reporting window, and the conditions that previously triggered the problem. A short local hashrate spike or a single quiet log interval cannot establish sustained improvement. Compare equivalent windows and keep environmental changes visible in the record.
If you have only one miner, the same worksheet still helps. It distinguishes “the update installed” from “this machine is ready to be left running.”
When the update does not finish as expected
The file is rejected: save the exact error and confirm the model, release path, package integrity and signature requirements. A missing-signature or unsupported-version message is a compatibility stop. Do not rename the file, remove validation, or keep trying unrelated images to force it through. Follow the vendor's explanation for that error.
The browser loses the miner: allow the documented process to finish, then check whether settings were cleared and the address changed. Confirm the physical unit and its current address before starting recovery. Loss of the old browser session alone does not prove a failed flash.
The interface returns but mining does not: check the installed version, expected configuration and worker attribution. Preserve new logs before another disruptive action. If boards or other hardware still fail under the same conditions, take the before-and-after evidence to support. If the control system cannot boot, obtain the exact recovery instructions for that hardware; a normal update file is not automatically a recovery image.
How quickly should the rest of the miners follow?
The difficult tradeoff is between acting on a relevant security or reliability fix and exposing several units to an untested local outcome. A serious vendor advisory may make delay costly, while limited onsite access or a restricted downgrade path can make simultaneous updates harder to recover from.
Ask what would justify changing the rollout pace: a clear advisory, successful observation under the site's problem conditions, support confirmation of a disputed hardware variant, or a workable recovery arrangement. Keep that decision tied to the release and the equipment you own. Before scheduling the remaining miners, complete the first-unit record and identify who can recover each location if management access changes.
Frequently asked questions
Can I use firmware from a similar ASIC miner model?
Use only a package whose official description covers the exact device and any stated subtype, board revision or starting-version conditions. Similar product names do not establish compatibility. Record the installed version and the complete target filename before uploading. If the hardware label, interface identity and download page do not agree, hold the update and ask the manufacturer to identify the supported transition.
Will a firmware update erase my pool and network settings?
That depends on the firmware and the option selected. The documented Antminer online workflow offers a configuration checkbox: retaining configuration preserves pool and network settings, while clearing it restores defaults and may change the address. Check your exact interface and release instructions. Keep a readable recovery record regardless of the selection, then verify the resulting values after the miner returns.
How long should I wait for the update to finish?
Follow the time and completion indicators in the procedure for your exact miner and installation method. An upload, a reboot and the return to accepted mining work can finish at different times. A browser that no longer reaches the old address may reflect changed network settings. Avoid interrupting power or repeating the upload just because another model's estimated waiting period has passed.
What should I do about a firmware signature error?
Preserve the exact message and recheck the official package, model match, supported version transition and download integrity. A signature error is a reason to resolve compatibility or authenticity, not to disable verification. If the matching documentation does not explain the result, contact support with the current version and target filename. Keep the miner's existing state and logs available while the next step is determined.
Can I downgrade if the new firmware causes problems?
Only when the manufacturer supports that exact transition. Some documented security firmware prevents returning to a previous version, and an old file saved on your computer does not override that restriction. Establish a supported recovery path before upgrading. If the new release fails acceptance, stop further rollout, retain the observations and request guidance instead of experimenting with older or unrelated packages.
How do I know the firmware update really worked?
Confirm the target version on the intended miner, review network and pool settings, and let initialization settle. Then verify that the correct pool account credits the expected worker with sustained accepted work. Compare logs and operating behavior against the saved baseline, including the specific reason for updating. An upload-success notice establishes only one stage; unresolved faults should remain open in the handover record.