Skip to content

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.

Choose my model

Open the full technical reference

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.

What's in front of you right now?

Tutorial No miner — just a computer Build the daemon, run our CI test suite, drive the full dashboard on mock telemetry. Nothing to buy, nothing to risk. Tier 0 · ~15 min · Linux or WSL Tutorial An Antminer S9 on the bench Boot DCENT_OS from an SD card. No NAND write — pull the card and stock firmware is back. Tier 2 · reversible · Zynq/XIL boards Tutorial A Bitaxe-class desk miner Flash from your browser over USB. Reflash stock ESP-Miner any time — nothing is permanent. Tier 1 · reversible · 16 devices
Mid-trial and something's wrong?

The testing ladder — what you risk, what it proves, how you undo it

DCENT_OS four-tier testing ladder
TierWhat you needWhat it provesThe undoStart here
0 — No hardwareA computer (Linux or WSL)The code is real: the CI suite passes on your machine and the UI is a real productDelete the checkoutRun DCENT_OS in 15 minutes
1 — Bitaxe-classA ~$100 deviceReal shares on real siliconReflash stock ESP-Miner over USB any time — the flash is fully rewritableThe browser flasher
2 — S9 reversible SD trialA bench S9 + an SD cardBoots, dashboards and mines on industrial iron — zero NAND writesPull the SD cardThe reversible SD trial
3 — Persistent installA supported model + a signed packageDaily-driver operationGated: backup-first, dry-run by default, plus the documented exit doorsS9 · S19j Pro

Get started

Tutorial Run DCENT_OS in 15 minutes — no miner required The same suite our CI runs, then the real dashboard UI on mock data. Tier 0 · ~15 min Tutorial First boot on an Antminer S9 — the reversible SD trial SD-boot writes nothing to NAND; management-only first boot, mining off until you enable it. Tier 2 · reversible Tutorial Flash a Bitaxe-class miner from your browser WebSerial flasher, per-image SHA256, reflash stock any time. Tier 1 · reversible How-to Readiness checklist The recovery-first pre-flight we run ourselves before any live test. 5 min

Install & recover

How-to Antminer S9 (Zynq/XIL) SD-boot quickstart + persistent Toolbox route + the full evidence ledger. Guarded artifact How-to Antminer S19j Pro (Zynq/XIL) Fingerprint the board first — this model ships four control-board lanes. Guarded artifact How-to Uninstall DCENT_OS / restore stock The exit door, documented before the entry is recommended. All lanes How-to Rollback & UART recovery Verified Zynq serial-console settings, boot-log reading, failure signatures. ttyPS0 · 115200 How-to Verify a download (SHA-256 / signatures) Check every artifact against the release ledger before it touches hardware. 5 min How-to SD-card firmware recovery Cross-vendor recovery media guide — the "known-good recovery path" the golden rule demands. Cross-vendor Reference NAND boot-chain corruption Which partition does what, and how corruption propagates. Deep dive

Operate & tune

Reference Configuration reference — dcentrald.toml Every documented key with its shipped default, and the clamps config cannot override. Repo-verbatim How-to Heat mode first boot Run an S9 as a space heater — the lab validation protocol. Heat How-to S9 tuning protocol Efficiency-first tuning order for a home S9, with the evidence gaps named. Tuning How-to Quiet home mining Low-noise S9 tuning — hash gets cut before noise rises. Quiet

Reference

Reference FAQ Dev fee, supported models, install and revert paths, brick risk — from the repo's own evidence. Honest answers Reference API & ports Dashboard, REST + WebSocket, CGMiner-compatible port 4028, MCP — evidence status per row. Surface map Reference Releases & artifacts Filename, byte size, SHA-256 and signing key for every release — verify before you flash. Checksums Reference beta-20260709 release evidence Per-release evidence record: lanes, limitations, review history. Current Reference ASIC firmware compatibility matrix Which firmware flashes on which model and control board — 22 models, all vendors. Site-wide Reference Beta status & readiness taxonomy What Verified / Supported / Experimental / Inferred / Unknown mean here. Vocabulary Reference LED reference Every status and locate pattern the firmware can drive, including the heartbeat that speeds up as the miner heats. Read it off the rack Reference MQTT, Home Assistant & webhooks The 13 entities it publishes, the 14 events it emits, and the three setpoints it will accept back. Both ship off Reference Off-grid & solar control Battery voltage zones, six chemistry presets, seven solar providers — and the ADC you must add before any of it runs. Schema only

Project

Overview DCENT_OS home What it is, what it runs on, and the public-beta boundary. Start Explanation Architecture Rust daemon, Buildroot, HAL and Stratum module map. System Explanation Security model Signing, trust boundaries, and what has not been independently audited. Trust Explanation Benchmark protocol No dataset is published yet; this is the protocol any dataset must satisfy. No-fabrication How-to Build from source What is open, what is not redistributed, and how to build the daemon. GPL-3.0 How-to Run from your own build Getting a self-compiled daemon onto a miner: per-board deploy policy, the two mandatory flags, and the recovery gap. No flash Reference Install routes by control board One model badge maps to several control boards. All 30 board targets and what each is authorized for. 1 of 30 How-to Independent reviewer kit Test an exact lane and publish success or failure. Reproduce How-to Contribute & lineage Bring-up rows get promoted by exactly this kind of community evidence. Community

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.

DCENT_OS status and evidence by exact Antminer model and control-board lane
HardwareRelease statusVerified prebuiltMining evidenceInstall / recoveryDetails
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.

Read the dated identity and status ledger