Sign inSign up

giiibates/fritzfluxdb

By giiibates

•Updated about 22 hours ago

Leightweight FritzBox metrics collector (TR-064 & Lua) and writes them to InfluxDBv1+v2/QuestDB

Image
Networking
Monitoring & observability
0

7.4K

giiibates/fritzfluxdb repository overview

fritzFluxDB Logo

⁠fritzFluxDB

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

Docker Pulls Platforms

Full documentation⁠

⁠Features

  • Collects TR-064 and Lua service data from the FRITZ!Box
  • Supports InfluxDB v1, InfluxDB v2 and QuestDB (the author's recommended backend), with optional server-side downsampling on QuestDB
  • Home automation, call logs, VPN, network hosts, system stats
  • Multi-arch image (amd64 / arm64), runs as non-root with Tini as PID 1
  • Restart watchdog; permanent configuration errors (exit status 78) park the container instead of looping
  • Graceful shutdown with measurement buffer flush
  • fritzflux-cli for QuestDB checks and cleanup (docker exec -it fritzfluxdb fritzflux-cli --help)

⁠Quick Start

The recommended setup uses QuestDB. Create a .env file:

FRITZBOX_HOSTNAME=192.168.178.1
FRITZBOX_USERNAME=<fritzbox-user>
FRITZBOX_PASSWORD=<fritzbox-password>

Create docker-compose.yml:

services:
  questdb:
    image: questdb/questdb:latest
    container_name: questdb
    restart: unless-stopped
    # No host ports: fritzfluxdb reaches QuestDB over the Compose network. QuestDB's HTTP/SQL
    # interface is unauthenticated by default; publish it only on loopback, e.g. "127.0.0.1:9000:9000".
    volumes:
      - questdb_data:/var/lib/questdb
    environment:
      - QDB_TELEMETRY_ENABLED=false

  fritzfluxdb:
    image: giiibates/fritzfluxdb:latest
    container_name: fritzfluxdb
    restart: unless-stopped
    stop_grace_period: 30s
    depends_on:
      - questdb
    env_file:
      - ./.env
    environment:
      TZ: Europe/Berlin
      LOG_LEVEL: INFO
      DB_TYPE: questdb
      QUESTDB_HOSTNAME: questdb
      QUESTDB_PORT: 9000
      QUESTDB_ALLOW_PLAINTEXT_CREDENTIALS: "true"
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    # The daemon only writes its PID file to /tmp.
    read_only: true
    tmpfs:
      - /tmp
    healthcheck:
      test: ["CMD-SHELL", "kill -0 \"$$(cat /tmp/fritzfluxdb.pid 2>/dev/null)\" 2>/dev/null || exit 1"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 15s

volumes:
  questdb_data:

Start it:

docker compose up -d

This starts QuestDB and fritzfluxdb on the same Compose network. Version 2.0.0 writes to fresh database schemas; use a new QuestDB instance. After a configuration error (exit status 78) the container stays up but unhealthy; fix .env and restart it. See Watchdog⁠. To use InfluxDB instead, omit the questdb service and set DB_TYPE=influxdb_v2 (or influxdb_v1) plus the INFLUXDB_* settings for an existing, reachable InfluxDB server. Plain HTTP credentials are rejected by default; enable INFLUXDB_ALLOW_PLAINTEXT_CREDENTIALS only on a trusted network, or set INFLUXDB_TLS_ENABLED=true when the endpoint supports HTTPS.

For InfluxDB setup, the full environment variable reference, and downsampling profiles, see Installation⁠ and Environment variables⁠ in the documentation.

⁠Grafana Dashboards

Example dashboards for every backend ship in the repository⁠: system, call log and router log, plus home automation for InfluxDB v2 and QuestDB. See Grafana dashboards⁠ for the import workflow.


This project is not affiliated with or endorsed by FRITZ.com GmbH, Alt-Moabit 95, 10559 Berlin. FRITZ!Box is a registered trademark of FRITZ.com GmbH.

Buy Me A Coffee

Tag summary

Content type

Image

Digest

sha256:6971559ba…

Size

47.9 MB

Last updated

about 22 hours ago

docker pull giiibates/fritzfluxdb