Skip to content

fritzFluxDB

fritzFluxDB Logo

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:

test -e .env || cat .env.example .env.questdb.example > .env

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.