DCENT_OS documentation: start here
DCENT_OS decision guide
Start with your miner, not a generic flashing guide
Choose the exact model and board first. The S9 has a guarded removable-media trial; the S19j Pro archive is limited to DCENT_OS self-update. Other lanes need their own evidence.
Risk: Experimental firmware can brick hardware, cause mining downtime, and may affect warranty coverage. Confirm the exact board and recovery path before any write.
Open the full technical reference
Home » DCENT_OS — Open-Source Antminer Firmware » DCENT_OS documentation: start here
Field documentation. Every page tells you what each step proves and how to undo it — that is the repo's own doctrine, and it is the structural law of every page below.
On this page
What's in front of you right now?
The testing ladder — what you risk, what it proves, how you undo it
| Tier | What you need | What it proves | The undo | Start here |
|---|---|---|---|---|
| 0 — No hardware | A computer (Linux or WSL) | The code is real: the CI suite passes on your machine and the UI is a real product | Delete the checkout | Run DCENT_OS in 15 minutes |
| 1 — Bitaxe-class | A ~$100 device | Real shares on real silicon | Reflash stock ESP-Miner over USB any time — the flash is fully rewritable | The browser flasher |
| 2 — S9 reversible SD trial | A bench S9 + an SD card | Boots, dashboards and mines on industrial iron — zero NAND writes | Pull the SD card | The reversible SD trial |
| 3 — Persistent install | A supported model + a signed package | Daily-driver operation | Gated: backup-first, dry-run by default, plus the documented exit doors | S9 · S19j Pro |
Get started
Install & recover
Operate & tune
Reference
Project
DCENT_OS hardware evidence and install readiness
Six axes stay separate: availability, maturity, binary, mining, installation and recovery. Evidence on one axis never silently promotes another.
| Hardware | Release status | Verified prebuilt | Mining evidence | Install / recovery | Details |
|---|---|---|---|---|---|
| Antminer S9 Zynq/Xilinx am1-s9; redundant-slot NAND, with a separate removable-media boot route | AVAILABILITY: RELEASED MATURITY: EXPERIMENTAL | A verified S9 Zynq/Xilinx sysupgrade archive and a bootable SD image are listed in the current artifact ledger. | The project platform matrix reports standalone cold-boot mining with pool-accepted shares on the BM1387 Zynq lane; this website does not claim an independent reproduction. | Bitmain's S9 recovery documentation distinguishes complete-board CRT0401/CRT0402 (JP4), CRT0302 (AB pads), and CRT0301 (no SD slot). The public DCENT_OS trial documents only the JP4 route; no other PCB revision inherits that authorization. The current public evidence still lacks a complete witnessed first-install, soak and persistent-recovery capstone for this release. For the documented removable-media trial, power off, return JP4 to its photographed original position, remove the SD card, then boot untouched NAND. Other S9 PCB revisions require their own verified route. A witnessed persistent stock-restoration procedure for this exact release is not published. | Evidence page |
| Antminer S9 SE Ctrl_C43 / XC7Z007S, tracked separately as am1-s9se | AVAILABILITY: RELEASED MATURITY: EXPERIMENTAL | No verified S9 SE prebuilt binary is listed in the current artifact ledger. The model still has AVAILABILITY: RELEASED and MATURITY: EXPERIMENTAL; build-output metadata is not a download. | The public source records exact model identity and detection evidence, but no callable production mining runtime or accepted-share proof for this lane. | The am1-s9se install row marks update, external media and general installation not implemented or denied. Do not use the S9 image. No model-specific installation write is authorized and no model-specific recovery-write route is published. | Evidence page |
| Antminer T17 Zynq/Xilinx am2-t17 with a PIC16 control path | AVAILABILITY: RELEASED MATURITY: EXPERIMENTAL | No verified T17 prebuilt binary is listed in the current artifact ledger. | The source row is management-only and does not establish a current accepted-share mining path on a live T17. | The am2-t17 install row has no implemented update or external-media route and denies installation. No model-specific persistent write or recovery procedure is authorized. | Evidence page |
| Antminer S17 Zynq/Xilinx; source mapping uses am2-s17p and must not be read as an S17 Pro install promise | AVAILABILITY: RELEASED MATURITY: EXPERIMENTAL | No verified S17 prebuilt binary is listed in the current artifact ledger. | The current evidence records a BM1397 source profile, not a reproduced accepted-share result on an exact S17 fleet unit. | The mapped source target has update and external media not implemented and installation denied. No separate exact-model route is published. No exact S17 persistent installation or stock-restoration procedure is authorized. | Evidence page |
| Antminer T17+ Zynq/Xilinx am2-t17plus with a PIC16 control path | AVAILABILITY: RELEASED MATURITY: EXPERIMENTAL | No verified T17+ prebuilt binary is listed in the current artifact ledger. | The source identifies the BM1397/PIC16 route, but the public evidence does not establish accepted shares on an exact T17+ unit. | The am2-t17plus install row marks update, media and recovery not implemented and installation denied. No model-specific persistent write or recovery route is published. | Evidence page |
| Antminer S17+ Zynq/Xilinx am2-s17plus with a PIC16 control path | AVAILABILITY: RELEASED MATURITY: EXPERIMENTAL | No verified S17+ prebuilt binary is listed in the current artifact ledger. | The source identifies the BM1397/PIC16 route, but the public evidence does not establish accepted shares on an exact S17+ unit. | The am2-s17plus install row marks update, media and recovery not implemented and installation denied. No model-specific persistent write or recovery route is published. | Evidence page |
| Antminer S19 Zynq/Xilinx source identity; no standalone exact S19 row exists in the canonical install matrix | AVAILABILITY: RELEASED MATURITY: EXPERIMENTAL | No verified S19 prebuilt binary is listed in the current artifact ledger. | The source retains BM1398 identity and shared driver-path work, but this registry does not claim current accepted shares on an exact S19 unit. | No standalone exact S19 row is published in the canonical install matrix. It must not silently inherit the S19 Pro or S19j Pro route. No exact-model persistent install or stock-restoration route is published. | Evidence page |
| Antminer S19 Pro Zynq/Xilinx am2-s19pro with redundant slots | AVAILABILITY: RELEASED MATURITY: EXPERIMENTAL | No verified S19 Pro prebuilt binary is listed in the current artifact ledger. A build producer name is not a public release asset. | Historical cold-boot work produced nonce flow, but no pool-accepted share is proven for the current native BM1398 path; current electrical admission remains fail-closed. | The am2-s19pro update mechanism is experimental and lab-only. Public-beta installation is false and no general stock-firmware first-install route is published. Generated boot-media evidence is lab-only; no model-specific operator recovery procedure is published. | Evidence page |
| Antminer S19j Pro Verified artifact: am2-s19j Zynq/Xilinx; BeagleBone, Amlogic, CVitek and STM32MP15 are separate, unauthorized lanes for that file | AVAILABILITY: RELEASED MATURITY: EXPERIMENTAL | A verified S19j Pro Zynq/Xilinx sysupgrade archive is listed in the current artifact ledger. | The project matrix reports accepted shares on the Zynq lane and historical runtime proof on BeagleBone; this website does not claim an independent reproduction. | The verified package supports a guarded DCENT_OS-to-DCENT_OS update on am2-s19j. Public vendor-stock first installation remains an evidence gap, and public_beta_install is false in the source matrix. No witnessed vendor-stock first-install and stock-restoration capstone is published for the exact artifact. | Evidence page |
| Antminer S19k Pro Amlogic am3-s19k, single-slot, NoPic lane | AVAILABILITY: RELEASED MATURITY: EXPERIMENTAL | No verified S19k Pro prebuilt binary is listed in the current artifact ledger. Build-producer metadata is not a download URL. | The current project ledger records a bounded Track-1 temporary-runtime accepted-share proof with terminal SafeOff, not an endurance or installed-image qualification. | The am3-s19k host-rootfs-window update is experimental and lab-only. No external-media route or public first-install procedure is authorized. Recovery is evidence-only in the source matrix; no general operator recovery runbook is published. | Evidence page |
| Antminer S21 Amlogic am3-s21, single-slot, NoPic lane | AVAILABILITY: RELEASED MATURITY: EXPERIMENTAL | No verified S21 prebuilt binary is listed in the current artifact ledger. | The project matrix records accepted shares on an earlier runtime path; that result has not been reproduced on a verified current public binary. | The am3-s21 host-rootfs-window path is experimental and lab-only. Stock AMLCtrl in-place installation remains blocked. No external-media or model-specific stock-restoration route is published. | Evidence page |
| Antminer S21 XP Amlogic am3-s21xp; package and exact topology evidence only | AVAILABILITY: RELEASED MATURITY: EXPERIMENTAL | No verified S21 XP prebuilt binary is listed in the current artifact ledger. | The source records exact topology and package-format evidence, but the installed runtime remains management-only and no accepted-share proof is claimed. | The am3-s21xp install row has no implemented update mechanism, denies installation and authorizes no persistent update. No external-media, installation-write or recovery route is published. | Evidence page |
| Antminer S21 Pro Amlogic am3-s21pro, single-slot, NoPic lane | AVAILABILITY: RELEASED MATURITY: EXPERIMENTAL | No verified S21 Pro prebuilt binary is listed in the current artifact ledger. | The source records an exact BM1370/Amlogic profile, but no current accepted-share proof on a verified public binary is claimed. | The am3-s21pro host-rootfs-window update is experimental and lab-only, with no authorized external-media route. No model-specific operator stock-restoration route is published. | Evidence page |
Reviewed 2026-08-29 against the public platform matrix. Exact board identity controls.
Documentation hub compiled 2026-08-13 against the public repository (TESTING.md tier ladder, INSTALL runbooks) and the live release directory. DCENT_OS is a public beta: experimental, it can brick hardware, never for revenue-critical machines.
Companion tool — DCENT_Toolbox: Install DCENT_Toolbox & run your first command · DCENT_Toolbox command reference · Install DCENT_OS with DCENT_Toolbox.
