Freifunk Dresden/Leipzig Docker-Servernode

Dieser Ordner enthält einen containerisierten Freifunk-Servernode mit:

• registrar (Registrierung, Node-ID, fastd/bmxd Runtime-Dateien)
• sysinfo (30s-Refresh von sysinfo.json + nodes.json)
• wireguard (Status-Logging für WireGuard-Peers)
• fastd + bmxd
• nginx (Port 80, UI + JSON-Endpunkte)

Quickstart

Voraussetzungen

• Docker + Docker Compose Plugin
• Linux-Host mit /dev/net/tun
• Der Container muss net.ipv4.ip_forward=1 aktivieren können

1) Konfiguration anlegen

cd dockernode
cp .env.example .env

Mindestens diese Werte in .env setzen:

• NODE_CONTACT_EMAIL
• NODE_NAME
• NODE_COMMUNITY (Dresden oder Leipzig)
• NODE_GPS_LATITUDE
• NODE_GPS_LONGITUDE

Optional:

• BACKBONE_PEERS leer lassen → Defaults aus config/defaults.yaml
• NODE_REGISTRATION_URL leer lassen → Defaults aus config/defaults.yaml
• REGISTRAR_INTERVAL muss zwischen 3600 und 21600 Sekunden liegen (1–6h)

2) Bauen

docker compose build dockernode

CI Release (Tag -> Image-Tag)

Bei einem Git-Tag-Push baut GitHub Actions automatisch ein Image und pusht es nach GHCR:

• ghcr.io/freifunkstuff/ffdd-node:<tag>
• Push auf master erzeugt zusätzlich: ghcr.io/freifunkstuff/ffdd-node:master

Beispiel:

git tag v1.0.0
git push origin v1.0.0

Ergebnis:

• ghcr.io/freifunkstuff/ffdd-node:v1.0.0

Pull-Beispiel:

docker pull ghcr.io/freifunkstuff/ffdd-node:master
docker pull ghcr.io/freifunkstuff/ffdd-node:v1.0.0

3) Starten

docker compose up -d dockernode

4) Erreichbarkeit prüfen

docker compose ps
curl -sSf http://127.0.0.1/sysinfo.json | head
curl -sSf http://127.0.0.1/nodes.json | head
curl -sSf http://127.0.0.1/ui/ | head

---

Betrieb

Services (runit)

Im Container laufen getrennte Dienste:

• registrar
• sysinfo
• wireguard
• fastd
• bmxd
• nginx

Status prüfen:

docker compose exec -T dockernode sh -lc 'sv status registrar; sv status sysinfo; sv status wireguard; sv status fastd; sv status bmxd; sv status nginx'

Einzelnen Dienst neu starten:

docker compose exec -T dockernode sv restart sysinfo

Logs ansehen:

docker compose logs -f dockernode

Persistenz

Persistente Daten liegen auf dem Host in:

• ./data/node.yaml

Darin werden u. a. gespeichert:

• registration.node_id
• registration.register_key
• fastd.secret
• wireguard.secret

Flüchtige Laufzeitdaten liegen im Container unter:

• /run/freifunk/fastd
• /run/freifunk/bmxd
• /run/freifunk/sysinfo
• /run/freifunk/www

Wichtige Endpunkte

• GET /sysinfo.json
• GET /sysinfo-json.cgi
• GET /nodes.json
• GET /ui/
• GET /licenses/* (Rechtstexte)

---

Wichtige Befehle (insb. bmxd -c)

Ausführen im Container:

docker compose exec -T dockernode <kommando>

bmxd-Status und Routing

bmxd -c status

• Kurzstatus des Daemons (Uptime/Node/IP/Last)

bmxd -c options

• Effektive bmxd-Parameter

bmxd -c --links

• Direkte Nachbarn + Linkqualität (RTQ, RQ, TQ)

bmxd -c --gateways

• Bekannte Gateways + bevorzugtes/ausgewähltes Gateway

bmxd -c --originators

• Originator-Tabelle (Mesh-Routen, Next-Hop, BRC)