DCENT_OS Documentation — Get Started, Install, Recover

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
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

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

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 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

Two axes are required: bench mining evidence and installation readiness. A signed download is not, by itself, a production-support claim.

DCENT_OS evidence by exact Antminer model and control-board lane
Hardware	Artifact	Mining evidence	Install readiness	Details
Antminer S9 Zynq / Xilinx (XIL)	Signed experimental artifact downloadable	Mining verified — accepted pool shares on bench hardware	Lab-gated; witnessed first-install, boot and recovery capstone not yet published	Evidence page
Antminer S19j Pro Zynq / Xilinx (artifact); BeagleBone and Amlogic are separate lanes	Signed experimental artifact downloadable for Zynq/XIL	Mining verified — accepted pool shares on Zynq; earlier runtime proof on BeagleBone	Guarded self-update from a DCENT_OS source state; vendor-stock first install remains an evidence gap	Evidence page
Antminer S19 Zynq / Xilinx	No public artifact	Bring-up — shares the S19 Pro driver path; no S19 accepted-share claim	In development; no public install route	Evidence page
Antminer S19 Pro Zynq / Xilinx	No public artifact	Hashing verified — cold boot, full-chain enumeration and nonce flow; accepted shares not verified on current binaries	Lab-gated; dedicated signed package and runbook pending	Evidence page
Antminer S21 Amlogic (documented runtime lane)	No public artifact	Mining verified on an earlier runtime path; not rerun on the latest binaries	Lab-only; stock AMLCtrl in-place installation remains blocked	Evidence page

Reviewed 2026-08-08 against the public platform matrix. Exact board identity controls.

Documentation hub reviewed 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.

Related products, repair, and setup paths

Last reviewed August 13, 2026.