fritzFluxDB

Lightweight daemon that collects metrics from your AVM FritzBox and pushes them into InfluxDB or QuestDB.

[!NOTE] Built on the shoulders of giants. This project is a fork of and would not exist without bb-Ricardo/fritzinfluxdb by Ricardo Bartels. The original laid the entire foundation for collecting FritzBox metrics into InfluxDB — a huge thank you for the years of work behind it. 🙏

📋 Table of Contents

• Why this fork?
• Features
• Quick Start
• Configuration
• Grafana Dashboards
• Local Development
• License

🔀 Why this fork?

The original project is excellent and battle-tested. This fork modernises the codebase and focuses on operational reliability, a smaller, container-first footprint, and adds QuestDB as a third storage backend alongside InfluxDB v1/v2.

The original still ships features this fork intentionally dropped (e.g. automatic retention-policy creation). If you rely on those, the upstream project may suit you better.

✨ Features

• Collects TR-064 & Lua service data from FritzBox
• Supports InfluxDB v1, InfluxDB v2 and QuestDB as storage backend
• Home automation metrics (smart home devices)
• Call logs & telephone data
• VPN, network hosts, connection info
• Multi-arch Docker image (amd64 / arm64)
• Runs as non-root with Tini as PID 1

🚀 Quick Start

1. Create a .env file

FRITZBOX_HOSTNAME=192.168.178.1
FRITZBOX_USERNAME=admin
FRITZBOX_PASSWORD=your-secret-password

DB_TYPE=influxdb_v2
INFLUXDB_HOSTNAME=influxdb
INFLUXDB_PORT=8086
INFLUXDB_ORGANIZATION=my-org
INFLUXDB_BUCKET=fritzflux
INFLUXDB_TOKEN=your-influxdb-token
# allow sending the token over plain HTTP inside your trusted home network
INFLUXDB_ALLOW_PLAINTEXT_CREDENTIALS=true

Using QuestDB instead? Set:

DB_TYPE=questdb
QUESTDB_HOSTNAME=questdb
QUESTDB_PORT=9000

2. Create docker-compose.yml

services:
  fritzfluxdb:
    image: giiibates/fritzfluxdb:latest
    container_name: fritzfluxdb
    restart: unless-stopped
    env_file:
      - ./.env
    environment:
      TZ: Europe/Berlin
      LOG_LEVEL: INFO

3. Run

docker compose up -d

That's it. Metrics will start flowing into your InfluxDB.

⚙️ Configuration

All settings can be passed via environment variables (e.g., in .env or in Docker Compose).

General Settings

[!TIP] TLS auto-detection: The hostname may be a full URL (e.g. https://influx.example.com behind a reverse proxy) — scheme and port are derived automatically. Port 443 always enables TLS.

FritzBox Configuration

InfluxDB Configuration (used when DB_TYPE=influxdb_v1 or influxdb_v2)

QuestDB Configuration (used when DB_TYPE=questdb)

📊 Grafana Dashboards

Pre-built dashboards are included in the grafana/ directory:

• System Dashboard — CPU, memory, uptime, temperatures
• Call Log Dashboard — Incoming/outgoing calls
• Logs Dashboard — FritzBox system logs
• Home Automation Dashboard — Smart home device metrics (InfluxDB v2)

Import the JSON files from grafana/influx2_dashboards/ (or influx1_dashboards/) into your Grafana instance.

🛠 Local Development

python3.13 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

python run.py -c setup.conf

📄 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 AVM GmbH or the FRITZ!Box product line. FRITZ!Box is a registered trademark of AVM GmbH.