Uninstall DCENT_OS — Restore Stock Firmware
Home » DCENT_OS — Open-Source Antminer Firmware » Uninstall DCENT_OS — Restore Stock Firmware
Closed firmware keeps you by locking the door. DCENT_OS keeps you — or doesn't — on the merits, so the exit is documented before the entry is recommended. The project's own testing doctrine puts it first: "always keep a known-good recovery path (SD card, stock/BraiinsOS slot, or a full NAND backup) before writing anything persistent to a miner." Here is every exit door, with its evidence status stated plainly.
Golden-rule quote: DCENT_OS repo TESTING.md ("Golden rule"), verbatim, fetched 2026-08-13.
On this page
Plan the exit for the package you actually chose
A settings export preserves configuration; it is not a full storage backup or a controller recovery image. Keep the package identity, original firmware or boot media, exact-unit backup and selected route's recovery instructions off the miner. A different controller's recovery image is not a substitute.
| Route | Before using it | Normal exit or failed-boot boundary |
|---|---|---|
| Exact native raw SD trial | Preserve internal firmware and the original boot selection; verify the full image layout and selected removable device | Complete Stop and shutdown, disconnect power, remove the card and restore the original boot selection if changed. These packages declare no NAND writes; a trial is not permission to rewrite internal storage |
| Base S9 first-install-only archive | Toolbox must confirm an eligible source-firmware route, accept the full backup for this exact unit and require appropriate controller recovery preparation | Use the retained route-specific restore procedure if the persistent installation does not boot. Removing a card is not a general undo for a persistent write; automatic failed-boot rollback is not guaranteed |
| S19j Pro Xilinx existing-runtime update | Eligible existing DCENT_OS runtime and inactive slot, full exact-unit backup and verified restore preparation | Keep backup and recovery media off the miner. Follow the recorded recovery procedure if the new slot fails; do not improvise raw boot-environment writes or assume an automatic slot rollback |
| S19j Pro BeagleBone developer SD payload | Keep original media; external AM335x boot assets, preparation and recovery are not supplied or verified by the public payload. No supported consumer installation path is provided | Any recovery depends on independently verified developer preparation for the exact board; this public payload does not supply a consumer trial or restore procedure. Keep original firmware and media. NAND installation and NAND revert remain disabled; a signature does not turn them into supported operations |
If the miner has not booted, do not assume a dashboard Stop is available. Keep power disconnected while changing media or boot selection and use only the exact controller's retained recovery instructions. Preserve failed-trial media and diagnostics. Physical recovery qualification remains pending for the current packages.
Check the method before entering it; Match the exact package and recovery card
Historical August 2026 exit references
The following material records earlier trial and recovery doctrine. It does not authorize a current package method, consumer BeagleBone installation or generic NAND revert. Use the current method-specific recovery table above.
| How you're running it | How you leave | What survives |
|---|---|---|
| Bitaxe / ESP device (flashed at /flash/) | Reflash the vendor's stock firmware over USB, any time | Everything — the ESP flash is fully rewritable; nothing is permanent |
/tmp runtime trial on an Antminer | Reboot | The incumbent firmware, untouched — the trial lived in RAM |
| S9 SD-boot trial | Power off, remove the card, power on | The previous NAND firmware boots — the trial never wrote to NAND |
| Persistent NAND install (Tier 3) | The Toolbox revert-to-stock lane — see below, and read it before you install, not after | Whatever recovery path you verified before flashing |
Sources: repo TESTING.md Tier 1 undo ("reflash stock ESP-Miner with esptool/Bitaxe web flasher at any time — the flash is fully rewritable over USB; nothing is permanent") and Tier 2 undo ("reboot. /tmp is RAM — the incumbent firmware boots untouched"); DCENT_OS_Antminer/docs/INSTALL/S9_XILINX.md ("Pulling the SD card returns the unit to its previous NAND firmware"); DCENT_Toolbox README.md (revert lane).
S9 SD trial: the full uninstall is removing a card
- Power the miner off.
- Remove the SD card and return JP4 to the original position you photographed before the trial.
- Power on. The previous NAND firmware boots, exactly as you left it — the trial never wrote to NAND.
The trial is "SD-boot only" — not SD-to-NAND. That is why the exit is this short.
Source: S9_XILINX.md — "That is SD-boot only — not 'SD install to NAND.'"; "Preferred path #1: SD-boot try (keep the card)" steps 3–5. Step-by-step detail with boot-log context: the rollback & recovery guide.
Historical persistent-install reference and proof limits
For persistent Antminer installs, DCENT_Toolbox documents a per-vendor revert-to-stock lane — dcent install --revert-to-stock — covering BraiinsOS recovery-mode NAND rewrite, VNish firmware/remove, and DCENT_OS/LuxOS uninstall.sh. The honest label from its own README: this lane is code-complete and operator-gated, with BraiinsOS/VNish live proof still pending.
This historical command fragment is not a complete restore procedure or a runnable instruction for every current package. Use only the exact-unit route and retained recovery inputs verified before the write. It does not apply to the BeagleBone developer payload; NAND installation and NAND revert are disabled there.
# The Toolbox revert lane (persistent installs; operator-gated)
dcent install --revert-to-stock
Two honesty notes, so this page never overstates its own exit:
- The DCENT_OS repository itself does not yet publish a witnessed restore-stock runbook for a persistent NAND install (we checked
docs/FAQ.mdanddocs/INSTALL/README.md, 2026-08-13). The revert lane above is documented in the DCENT_Toolbox repository — and it carries that repository's own proof-pending label. - When a witnessed restore-stock runbook ships in the DCENT_OS repo, this page will carry it the same day, with the same sourcing discipline as everything above.
The guardrails around the persistent-install boundary
| Guardrail | Published behavior |
|---|---|
| Gates before any permanent write | Tier 3 goes through DCENT_Toolbox, which enforces the safety gates: backup-first, degraded-hardware refusal, dry-run by default, signed-package verification. The dry run previews exactly what would be written — run it freely; it writes nothing |
| Recovery-path prerequisite | The install guide requires a known-good recovery path and warns "Automatic failed-boot rollback is not guaranteed — keep serial and SD or a verified full-NAND restore path" before flashing — the exit is a precondition, not an afterthought |
| Historical A/B-slot Zynq primitive | Earlier project-reported S19j Pro Xilinx bench evidence records a slot-selection primitive. It does not qualify automatic rollback or restoration for the current artifact. Do not infer a BeagleBone or other controller operation, and do not improvise raw boot-environment writes. |
| Residual safety net | A serial or SD console available before the first post-flash power-cycle |
Sources: repo TESTING.md Tier 3 (gates list, dry-run paragraph); DCENT_OS_Antminer/docs/INSTALL/README.md (rollback-not-guaranteed warning, quoted verbatim); Bible BIBLE_2026_05_17_DCENTOS_XIL_PERSISTENT_FW_SETENV.md §4–§6 (fw_setenv slot flip, BraiinsOS teardown, §6.5 console safety net).
The consequence, without hedging: if you cannot verify a stock or known-good slot, or hold a complete NAND backup, before a persistent write — do not make the persistent write. The reversible SD trial exists precisely so you never have to gamble.
Verify before you flash anything back
Whichever direction you are flashing — out of DCENT_OS or back into it — check the artifact first. The firmware verification guide covers SHA-256 and signature checks; the ASIC firmware compatibility matrix tells you which install media and recovery path your exact model and control board actually use; and the readiness checklist is the pre-flight we run ourselves.
Reviewed 2026-08-13 against the DCENT_OS repository (TESTING.md, INSTALL docs) and the DCENT_Toolbox README. A firmware you cannot leave is a firmware you do not own.
Companion tool — DCENT_Toolbox: DCENT_Toolbox backup & recovery commands · Revert-to-stock with DCENT_Toolbox.
Related: Restore stock firmware: safe downgrade guide.
