Files
composes/netdata
tiennm99 23b9bf8bf6 docs: describe current state only, and fill in the stub READMEs
Drop the history and roadmap asides: which services predate the collection's
conventions, the unwired Open Web UI plan, the generic clone-and-troubleshoot
boilerplate. Services that publish ports or set `restart:` now simply say so.

couchbase, openvpn-as and traffmonetizer had two-line READMEs; give them the
ports, variables and storage the root README promises. traffmonetizer reads
${TOKEN} and had no .env.example, so add one.
2026-09-16 20:45:18 +07:00
..
2025-03-24 20:51:11 +07:00

netdata

Netdata monitoring agent.

Uses docker-compose.yml, and sets restart: unless-stopped and container_name: netdata — unlike the platform-managed services described in the root README.

Runs with network_mode: host and pid: host, plus SYS_PTRACE/SYS_ADMIN and an unconfined AppArmor profile, so it can read host processes and metrics. The dashboard is therefore on the host's own 19999, not a published port.

Environment

Variable Purpose
NETDATA_CLAIM_TOKEN Netdata Cloud claim token. Without it the agent runs standalone.
NETDATA_CLAIM_TOKEN=<token> docker compose up -d

Storage

Volume Mount Holds
netdataconfig /etc/netdata Agent configuration
netdatalib /var/lib/netdata Metrics database, claim state
netdatacache /var/cache/netdata Cache

Host paths (/, /proc, /sys, /var/log, the Docker socket, dbus) are mounted read-only for collection.

  • alloy — ships metrics to Grafana Cloud instead