fritzfluxdb
Docker app from GillBates' Repository
Give your FRITZ!Box a history. fritzFluxDB collects DSL/cable, Wi-Fi, VPN, call, smart-home and router data and sends it to InfluxDB or QuestDB. Import the included Grafana…
Overview
Readme
View on GitHub
fritzFluxDB
Lightweight daemon that collects metrics from your FRITZ!Box and pushes them into InfluxDB or QuestDB.
Latest Version
Docker Pulls
License: MIT
Multi-arch: amd64, arm64
Features
| Area | Detail |
|---|---|
| Backends | InfluxDB v1, InfluxDB v2, QuestDB 10+ (recommended; optional server-side downsampling) |
| Data | TR-064 and Lua services, home automation, call list, router log, VPN, network hosts, system statistics |
| Container | Multi-arch (amd64/arm64), non-root, Tini as PID 1, restart watchdog, buffer flush on shutdown, fritzflux-cli for QuestDB checks and cleanup |
| Dashboards | System, call log and router log dashboards for every backend, plus home automation for InfluxDB v2 and QuestDB, in utils/grafana/ |
This fork runs on Python 3.13, writes through a single httpx client, and backs off exponentially
on HTTP errors. See the comparison with the original.
Quick Start
Version 2.0.0 starts with fresh database schemas. Use a new QuestDB instance, InfluxDB database or bucket; nothing is migrated and existing data is not touched. Home-automation devices are identified by their AIN in the
idtag, andnamestays a display tag.
test -e .env || cat .env.example .env.questdb.example > .env
# edit .env with your FRITZ!Box settings
docker compose -f docker/docker-compose.questdb.yml up -d
The Compose file starts QuestDB together with fritzfluxdb. For InfluxDB, build .env from
.env.example plus .env.influxdb.example and start docker/docker-compose.influx2.yml (or
docker-compose.influx1.yml); these files start fritzfluxdb only, so an existing InfluxDB must be
reachable from the container. For a local Python run, see
Installation and
Docker Compose.
Documentation
License
MIT — © 2026 Gill-Bates
Disclaimer: This project is an independent open-source tool and is not affiliated with, endorsed by, or in any way associated with FRITZ.com GmbH, Alt-Moabit 95, 10559 Berlin, or the FRITZ!Box product line. FRITZ!Box is a registered trademark of FRITZ.com GmbH.
Categories
Download Statistics
Related apps
Explore more like this
Explore allLinks
Details
giiibates/fritzfluxdb:latestRuntime arguments
- Network
bridge- Shell
bash- Privileged
- false
- Extra Params
--restart unless-stopped --health-cmd='kill -0 "$(cat /tmp/fritzfluxdb.pid 2>/dev/null)" 2>/dev/null || exit 1' --health-interval=30s --health-timeout=10s --health-retries=3 --health-start-period=15s
Template configuration
Container and log timezone (e.g. Europe/Berlin, Etc/UTC). Set the Fritz!Box timezone separately to match the router.
- Target
- TZ
- Default
- Europe/Berlin
- Value
- Europe/Berlin
Log level.
- Target
- LOG_LEVEL
- Default
- INFO|DEBUG|WARNING|ERROR
- Value
- INFO
Hostname or IP of the Fritz!Box on your LAN.
- Target
- FRITZBOX_HOSTNAME
- Default
- 192.168.178.1
- Value
- 192.168.178.1
Fritz!Box login username.
- Target
- FRITZBOX_USERNAME
Fritz!Box login password.
- Target
- FRITZBOX_PASSWORD
Fritz!Box TR-064 port.
- Target
- FRITZBOX_PORT
- Default
- 49000
- Value
- 49000
Connection timeout in seconds.
- Target
- FRITZBOX_CONNECT_TIMEOUT
- Default
- 10
- Value
- 10
Seconds between TR-064 poll cycles (minimum 10).
- Target
- FRITZBOX_REQUEST_INTERVAL
- Default
- 10
- Value
- 10
Seconds between WAN and DSL status checks for interruption classification. Use 0 to disable; otherwise 2 to 60. Independent of the request interval.
- Target
- FRITZBOX_WAN_WATCH_INTERVAL
- Default
- 5
- Value
- 5
Custom tag to identify the Fritz!Box.
- Target
- FRITZBOX_BOX_TAG
- Default
- fritz.box
- Value
- fritz.box
IANA timezone configured on the Fritz!Box, used for router log and call timestamps. The daemon checks its offset at startup but does not auto-detect the timezone.
- Target
- FRITZBOX_TIMEZONE
- Default
- Europe/Berlin
- Value
- Europe/Berlin
Optional existing PEM certificate or CA file on the Unraid host. Mounts read-only at /etc/fritzfluxdb/fritzbox-ca.pem; leave empty if unused.
- Target
- /etc/fritzfluxdb/fritzbox-ca.pem
Set to /etc/fritzfluxdb/fritzbox-ca.pem when a host certificate is mapped above. Verifies the Fritz!Box HTTPS Lua endpoint; leave empty if unused.
- Target
- FRITZBOX_CA_FILE
Leave empty to exclude VPN address metrics; enter 1, true, yes, or on to include them.
- Target
- FRITZFLUXDB_INCLUDE_VPN_ADDRESS_METRICS
Target database. InfluxDB v1 needs a database name; InfluxDB v2 needs token, organization and bucket; QuestDB needs a host and optionally HTTP basic credentials.
- Target
- DB_TYPE
- Default
- influxdb_v1|influxdb_v2|questdb
- Value
- influxdb_v1
Hostname or IP of the target database (InfluxDB or QuestDB). A full URL is also accepted, e.g. https://questdb.example.com, in which case TLS and port are taken from the URL.
- Target
- INFLUXDB_HOSTNAME
Leave EMPTY to use the correct default for the selected Database Type (8086 for InfluxDB, 9000 for QuestDB). Only set this if your database listens on a non-standard port.
- Target
- INFLUXDB_PORT
Enable TLS (HTTPS) for the database connection.
- Target
- INFLUXDB_TLS_ENABLED
- Default
- false|true
- Value
- false
Verify the database TLS certificate.
- Target
- INFLUXDB_VERIFY_TLS
- Default
- true|false
- Value
- true
Allow sending credentials/token over plain HTTP to a remote host (trusted networks only).
- Target
- INFLUXDB_ALLOW_PLAINTEXT_CREDENTIALS
- Default
- false|true
- Value
- false
InfluxDB measurement or QuestDB table base name. The Fritz!Box serial normally replaces it; QuestDB then creates separate name_metrics and name_events tables.
- Target
- INFLUXDB_MEASUREMENT_NAME
- Default
- fritzbox
- Value
- fritzbox
InfluxDB v1 database name. Required for DB_TYPE=influxdb_v1, ignored otherwise.
- Target
- INFLUXDB_DATABASE
Username for InfluxDB v1 or QuestDB basic authentication (optional). For InfluxDB v1 it must be set together with the password.
- Target
- INFLUXDB_USERNAME
Password for InfluxDB v1 or QuestDB basic authentication (optional). For InfluxDB v1 it must be set together with the username.
- Target
- INFLUXDB_PASSWORD
InfluxDB v2 API token (required for DB_TYPE=influxdb_v2). QuestDB Open Source does not support API tokens.
- Target
- INFLUXDB_TOKEN
InfluxDB v2 organization name. Required for DB_TYPE=influxdb_v2, ignored otherwise.
- Target
- INFLUXDB_ORGANIZATION
InfluxDB v2 bucket. Required for DB_TYPE=influxdb_v2, ignored otherwise.
- Target
- INFLUXDB_BUCKET
QuestDB 10 or newer only: TTL in days; 0 disables it. The raw metrics table gets a TTL only if it has none. Ignored for InfluxDB.
- Target
- INFLUXDB_DATA_RETENTION_DAYS
- Default
- 365
- Value
- 365
Optional QuestDB rollup profile: low (30 days raw, 1-minute rollup), medium (7 days raw, 1-minute rollup), or high (1 day raw, 5-minute rollup). Leave empty to disable.
- Target
- QUESTDB_DOWNSAMPLING