fritzfluxdb

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
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 dashboards to follow trends. When the WAN drops, fritzFluxDB records the interruption and a likely cause to help you investigate. Choose InfluxDB v1/v2 or QuestDB 10+ during installation. The collector runs in the background with no Web UI or inbound ports. Upgrading from before 2.0.0? Use a fresh QuestDB instance or a new InfluxDB database/bucket and re-import the dashboards; existing data is not migrated.

fritzFluxDB Logo

fritzFluxDB

Lightweight daemon that collects metrics from your FRITZ!Box and pushes them into InfluxDB or QuestDB.

Latest Version CI Docker Build Docker Pulls License: MIT Multi-arch: amd64, arm64

Quick Start Documentation

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/

Grafana system dashboard showing FritzBox connection, CPU, RAM and traffic panels

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 id tag, and name stays 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.

Buy Me A Coffee

Categories

Download Statistics

6,451
Total Downloads

Related apps

Links

Details

Repository
giiibates/fritzfluxdb:latest
Last Updated2026-09-30
First Seen2026-06-08

Runtime 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

TimezoneVariable

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 LevelVariable

Log level.

Target
LOG_LEVEL
Default
INFO|DEBUG|WARNING|ERROR
Value
INFO
Fritz!Box Hostname/IPVariable

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 UsernameVariable

Fritz!Box login username.

Target
FRITZBOX_USERNAME
Fritz!Box PasswordVariable

Fritz!Box login password.

Target
FRITZBOX_PASSWORD
Fritz!Box PortVariable

Fritz!Box TR-064 port.

Target
FRITZBOX_PORT
Default
49000
Value
49000
Fritz!Box Connect Timeout (s)Variable

Connection timeout in seconds.

Target
FRITZBOX_CONNECT_TIMEOUT
Default
10
Value
10
Fritz!Box Request Interval (s)Variable

Seconds between TR-064 poll cycles (minimum 10).

Target
FRITZBOX_REQUEST_INTERVAL
Default
10
Value
10
WAN Watch Interval (s)Variable

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
Fritz!Box Box TagVariable

Custom tag to identify the Fritz!Box.

Target
FRITZBOX_BOX_TAG
Default
fritz.box
Value
fritz.box
Fritz!Box TimezoneVariable

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
Fritz!Box CA Certificate (host path)Pathro

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
Fritz!Box CA File (container path)Variable

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
Include VPN Address MetricsVariable

Leave empty to exclude VPN address metrics; enter 1, true, yes, or on to include them.

Target
FRITZFLUXDB_INCLUDE_VPN_ADDRESS_METRICS
Database TypeVariable

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
Database Hostname/IPVariable

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
Database PortVariable

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
Database TLSVariable

Enable TLS (HTTPS) for the database connection.

Target
INFLUXDB_TLS_ENABLED
Default
false|true
Value
false
Database Verify TLSVariable

Verify the database TLS certificate.

Target
INFLUXDB_VERIFY_TLS
Default
true|false
Value
true
Database Allow Plaintext CredentialsVariable

Allow sending credentials/token over plain HTTP to a remote host (trusted networks only).

Target
INFLUXDB_ALLOW_PLAINTEXT_CREDENTIALS
Default
false|true
Value
false
Measurement / Table Base NameVariable

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
Database Name (InfluxDB v1)Variable

InfluxDB v1 database name. Required for DB_TYPE=influxdb_v1, ignored otherwise.

Target
INFLUXDB_DATABASE
Database Username (InfluxDB v1 / QuestDB)Variable

Username for InfluxDB v1 or QuestDB basic authentication (optional). For InfluxDB v1 it must be set together with the password.

Target
INFLUXDB_USERNAME
Database Password (InfluxDB v1 / QuestDB)Variable

Password for InfluxDB v1 or QuestDB basic authentication (optional). For InfluxDB v1 it must be set together with the username.

Target
INFLUXDB_PASSWORD
Token (InfluxDB v2)Variable

InfluxDB v2 API token (required for DB_TYPE=influxdb_v2). QuestDB Open Source does not support API tokens.

Target
INFLUXDB_TOKEN
Organization (InfluxDB v2)Variable

InfluxDB v2 organization name. Required for DB_TYPE=influxdb_v2, ignored otherwise.

Target
INFLUXDB_ORGANIZATION
Bucket (InfluxDB v2)Variable

InfluxDB v2 bucket. Required for DB_TYPE=influxdb_v2, ignored otherwise.

Target
INFLUXDB_BUCKET
Data Retention (days, QuestDB only)Variable

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
Downsampling (QuestDB only)Variable

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