DCENT_OS Configuration Reference — dcentrald.toml

DCENT_OS is configured through a single TOML file. This page reproduces the repository's configuration reference for the current beta — file locations, every documented key with its shipped default, and the safety clamps that config cannot override. The repo copy is authoritative: DCENT_OS_Antminer/docs/CONFIGURATION.md.

File locations and how to apply changes

Configuration surfaces (Antminer builds, beta20260709 era)
What	Where	Notes
Active config	`/data/dcentrald.toml`	Overrides the baked default; survives reboots and A/B upgrades
Baked default	read-only, ships inside the image	Fallback when no `/data` copy exists
Edit via	dashboard · REST API · directly over SSH	All three are documented edit paths
Apply	`/etc/init.d/S82dcentrald restart`	Restart the daemon after direct edits

Build-specific: the init-script name and /data layout are properties of the Antminer Buildroot images; the ESP32 member (DCENT_OS_ESP/) is configured through its first-run wizard instead (source: TESTING.md, Tier 1).

Key sections — verbatim from the repo

[mining]
enabled        = false   # fresh installs boot management-only until you enable mining
frequency_mhz  = 525     # per-platform; the autotuner adjusts within safe bounds

[[pool]]                 # your pool (you keep 100% of this hashtime)
url      = "stratum+tcp://your.pool:3333"
worker   = "your-btc-address-or-account"
password = "x"

[donation]               # optional, transparent, fully disableable
enabled       = true
percent       = 2.0      # 0.0–5.0; set 0 or enabled=false to turn it off
pool_url      = "stratum+tcp://pool.d-central.tech:3333"   # DCENT_Pool (Solo/Guild)
worker        = "DungeonMaster"
fallback_pool_url = "stratum+tcp://stratum.braiins.com:3333"  # used only if the primary is down
fallback_worker   = "DungeonMaster"
cycle_duration_s  = 3600 # at 2%, that's ~72s of donation per hour

[thermal]
fan_max_pwm = 30         # home/quiet cap; the daemon cuts hash before exceeding this

[power.psu_override]      # supported PSU-bypass lane; no smart-PSU/Loki when the platform matrix allows it
enabled  = false
model    = "APW3"
voltage_v = 12.8

Build-specific markers: frequency_mhz = 525 is a per-platform default (the autotuner adjusts within safe bounds); the [power.psu_override] lane is only valid where the platform matrix allows PSU bypass — Amlogic/BeagleBone bypass remains live-soak gated (source: docs/PLATFORMS.md, "Power supplies"). Keys can change between beta releases; treat the repo file as canonical for your exact build.

The donation, precisely

The donation is a voluntary, transparent slice of hashtime — never a hidden dev fee. It routes to DCENT_Pool and shows a live "DONATING" indicator on the dashboard whenever it's active. Set percent = 0 or enabled = false to disable it entirely. If the primary donation endpoint is temporarily unreachable, a visible backup route keeps the (still-bounded) donation slice flowing — it never extends your configured percentage and is never part of your own pool's failover.

Safety-relevant settings

[thermal].fan_max_pwm caps fan noise for home/quiet operation. The daemon cuts hash power before exceeding this cap; raising it is an explicit choice.
[mining].enabled = false keeps a fresh unit management-only (no hash power) until you opt in.
Voltage and frequency are bounded by per-chip silicon profiles with hard clamps you can't exceed from config.

Cross-reference: DCENT_Toolbox documents the same clamps from the bench side as a do-not-regress guarantee — voltage_mv ≤ 14,500 on am2 boards and the fan_max_pwm ≤ 30 home-use cap (source: DCENT_Toolbox README.md, do-not-regress list).

Going deeper

Reproduced verbatim-faithful from DCENT_OS_Antminer/docs/CONFIGURATION.md (main branch, fetched 2026-08-13). The repo file is the source of truth for your build; this page tracks the beta20260709-era layout. Last reviewed: August 13, 2026.

Related products, repair, and setup paths

Last reviewed August 13, 2026.