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

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.