Skip to main content

Dash Config

Dash config is YAML. The admin password is read only from monitor_dash_pwd, not from the config file.

File Path

Release install writes:

/opt/Ithiltir-dash/configs/config.local.yaml

Source runs can use any path passed with -config.

App

app:
listen: ":8080"
public_url: "https://dash.example.com"
node_offline_threshold: "30s"
trusted_proxies:
- "127.0.0.1/32"
FieldDescription
app.listenDash listen address
app.public_urlPublic root URL used for generated node commands and callbacks
app.node_offline_thresholdOffline threshold for node reports
app.trusted_proxiesCIDRs trusted for forwarded headers

app.public_url must be a root URL. URL subpaths such as /dash are not supported.

Database

database:
host: "127.0.0.1"
port: 5432
user: "ithiltir"
password: "secret"
name: "ithiltir"
retention_days: 45
traffic_retention_days: 90

Dash requires PostgreSQL 16+ and TimescaleDB.

Redis

redis:
addr: "127.0.0.1:6379"
password: ""
db: 0

Without --no-redis, Dash connects to Redis and exits on failure.

Security

security:
jwt_secret: "<random>"
cookie_hash_key: "<random>"
cookie_block_key: "<random>"

Changing these values invalidates existing browser sessions.

Logging

log:
level: "info"

Use -debug for temporary diagnosis.