DCENT_OS Configuration Reference — dcentrald.toml

This existing TOML reference describes configuration options. Verify each default against the exact current generated recipe and source version; other retained example values are illustrative, not promises for every controller. October donation defaults are corrected below.

File locations and how to apply changes

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 = false
percent = 0.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 # example schedule; not a share or payout guarantee

[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

October default configuration disables donations at 0%; retained miner settings may differ. Optional contributions redirect scheduled mining time in Stratum V1, configured from 0 to 5%. Set the percentage to 0 or disable the contribution to opt out; saved changes require a daemon restart. Scheduled time is not a guarantee of accepted-share, payout or wall-clock percentages. Settings > Donation Fee displays pool and worker configuration; API/TOML configuration is available. See the exact October release and voluntary development support.

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.