fritzFluxDB¶
fritzFluxDB is a lightweight, container-friendly daemon that collects metrics from a FRITZ!Box and writes them to InfluxDB v1, InfluxDB v2, or QuestDB. It also exposes call logs, router logs, VPN data, network hosts, connection information, system statistics, and supported smart-home metrics to the selected time-series backend.
QuestDB is the recommended backend
InfluxDB v1 and v2 remain supported. See Backend overview for the reasons.
Start here¶
The recommended deployment is Docker Compose with QuestDB. Create .env from the basic template and the QuestDB template, then edit it with your FRITZ!Box values:
For InfluxDB, use .env.influxdb.example instead. Template and Compose file per backend are listed in Docker Compose; the backends are compared in Backend overview.
Credentials stay local
The examples in this documentation use placeholders only. Keep .env, tokens, passwords, and exported database credentials outside Git and never paste them into issue reports.
What the daemon does¶
flowchart LR
B["FRITZ!Box"]
subgraph C["fritzFluxDB container"]
W["Watchdog<br/>(entrypoint.sh)"]
F["Daemon"]
H["Healthcheck"]
end
I["InfluxDB v1/v2"]
Q["QuestDB 10+"]
G["Grafana"]
F <-->|"TR-064 SOAP, port 49443 (HTTPS), 49000 (HTTP fallback)<br/>and Lua login; FRITZ!Box user and password"| B
F -->|"HTTP line protocol, /write or /api/v2/write<br/>password (v1) or token (v2)"| I
F -->|"HTTP line protocol, /write<br/>optional basic auth"| Q
G -->|"InfluxQL or Flux queries"| I
G -->|"SQL over HTTP, /exec"| Q
W -->|"starts and restarts"| F
F -.->|"exit 78: watchdog parks"| W
H -.->|"checks PID file"| F Communication paths: the daemon polls the FRITZ!Box and writes to InfluxDB or QuestDB; Grafana reads from the backend. The watchdog restarts the daemon on failures but parks on exit status 78 (see Watchdog).
The daemon polls the FRITZ!Box asynchronously, buffers measurements, and flushes them before a graceful shutdown when possible. The image runs as a non-root user with Tini and a watchdog.
Documentation map¶
| Page | Content |
|---|---|
| Installation | Prerequisites and deployment choices |
| Environment variables | Runtime configuration |
| Polling and data model | Collection cadence and measurement naming |
| Docker watchdog | Restart behaviour and exit codes |
| InfluxDB, QuestDB | Backend-specific setup |
| Grafana dashboards | Import and datasource requirements |
| Troubleshooting | Symptoms and fixes |
| Architecture | Code layout and runtime flow |
The changelog lists the released versions and their notes. The project is independent open source software and is not affiliated with FRITZ.com GmbH, Alt-Moabit 95, 10559 Berlin.