Firmware-Update am 1. August: Bekannter Fehler im Update-Prozess - manuelles Update empfohlen

Liebe Freifunkerinnen und Freifunker,

am 1. August 2026 verteilen wir per automatischem Update die Firmware v2025.12.3 an alle Knoten. Es handelt sich um ein kleines Wartungsupdate mit einer wichtigen Fehlerbehebung: Es behebt einen Fehler, der den Update-Vorgang selbst betreffen kann.

Das Wichtigste in Kürze:

• Auf Knoten mit Firmware v2025.12.2 oder älter kann ein bekannter Fehler dazu führen, dass der Knoten beim Update hängen bleibt. Beim vergleichbaren Rollout im Januar war das bei rund 10 % der Knoten der Fall.
• Ein hängender Knoten ist danach offline und aus der Ferne nicht erreichbar. Er lässt sich dann nur vor Ort durch Ziehen des Stromsteckers wieder in Betrieb nehmen.
• Das lässt sich vermeiden: Per SSH einloggen und mit den Befehlen unten das Update selbst und sicher anstoßen. Der Vorgang dauert wenige Minuten und wird allen mit SSH-Zugriff auf ihren Knoten empfohlen.
• Knoten bei denen WiFi Mesh deaktiviert wurde, sind nicht betroffen.

Ist mein Knoten betroffen?

Die Firmware-Version eures Knotens findet ihr auf dessen Statusseite oder auf der Knotenkarte.

Betroffen sind Knoten, die per WLAN meshen (802.11s) und dabei Mesh-Nachbarn in Reichweite haben. Knoten, die ausschließlich per VPN oder Kabel (Mesh-on-LAN/WAN) angebunden sind, sind nicht betroffen; die Anleitung kann aber auch dort gefahrlos angewendet werden.

Was ist passiert?

Beim Stable-Rollout im Januar blieben rund 10 % der Knoten beim Update hängen. Anhand von Rückmeldungen und Logs aus der Community konnten wir die Ursache ermitteln: ein Fehler in batman-adv, unserem Mesh-Routing-Protokoll. Beim Herunterfahren der WLAN-Mesh-Schnittstellen während des Updates können sich zwei Teile des Kernels gegenseitig blockieren (ein sogenannter Deadlock). Der Update-Vorgang erreicht dadurch nie das eigentliche Flashen, und der Knoten bleibt in diesem Zustand hängen.

Der Fehler ist inzwischen im offiziellen Linux-Kernel behoben, und v2025.12.3 enthält genau diesen Fix. Die Schwierigkeit dabei: Während des Updates läuft noch die alte Firmware, die den Fehler noch enthält. Deshalb kann bereits das Update auf die fehlerbereinigte Version selbst hängen bleiben.

Anleitung: Update manuell durchführen

Bitte nur ausführen, wenn euer Knoten v2025.12.2 oder älter hat (siehe Tabelle oben). Voraussetzung ist SSH-Zugriff auf euren Knoten (SSH-Schlüssel oder Passwort, wie im Config-Mode hinterlegt).

Schritt 1: Per SSH mit dem Knoten verbinden (die Adresse findet ihr z. B. auf der Knotenkarte):

ssh root@<adresse-eures-knotens>

Schritt 2: Diese Zeilen als Ganzes kopieren, einfügen und mit Enter bestätigen:

for i in $(batctl if | cut -d: -f1); do
    [ -d "/sys/class/net/$i/phy80211" ] && batctl hardif "$i" throughput_override 10mbit
done
sleep 5
autoupdater -f -b experimental

Die ersten Zeilen umgehen die fehlerhafte Stelle in batman-adv (das WLAN-Mesh erhält bis zum nächsten Neustart einen festen statt eines laufend gemessenen Metrik-Werts, was unbedenklich ist). Die letzte Zeile installiert v2025.12.3 sofort. Der Zusatz »experimental« bedeutet hier nicht, dass eine experimentelle Firmware installiert wird: Es handelt sich um exakt dieselbe Version v2025.12.3, die am 1. August ohnehin verteilt wird; sie wird an dieser Stelle lediglich vorab bereitgestellt. Der Knoten bleibt dauerhaft auf dem stable-Zweig, die Option gilt nur für diesen einen Aufruf.

Schritt 3: Abwarten. Der Knoten lädt die neue Firmware, die SSH-Verbindung bricht ab, und der Knoten startet neu. Nach etwa 10 Minuten ist er mit v2025.12.3 wieder online. Der Vorgang ist damit abgeschlossen; das automatische Update am 1. August betrifft den Knoten dann nicht mehr.

Zwei Hinweise:

• Meldet der Autoupdater »no new version available«, ist der Knoten bereits aktuell.
• Bitte die Zeilen in einem Durchgang inklusive Update ausführen. Der Schutz gilt nur bis zum nächsten Neustart; nur die ersten Zeilen auszuführen und das Update später nachzuholen, hat daher keine Wirkung.

Was passiert ohne manuelles Eingreifen?

Dann versucht der Knoten das Update ab dem 1. August automatisch - ohne den beschriebenen Schutz. In den meisten Fällen verläuft das Update ohne Probleme. Andernfalls bleibt der Knoten hängen: Er ist offline und aus der Ferne nicht erreichbar. In diesem Fall hilft nur, den Stromstecker zu ziehen, 10 Sekunden zu warten und ihn wieder einzustecken.

Dabei entsteht kein dauerhafter Schaden: Der Knoten startet anschließend mit der alten Firmware und versucht das Update später erneut. Dabei kann er wieder hängen bleiben, bis das Update einmal erfolgreich durchläuft. Wir empfehlen daher, nach dem 1. August kurz auf der Karte zu prüfen, ob der Knoten noch online ist.

Wer Knoten an schwer zugänglichen Standorten betreibt (Dach, Keller, Ferienhaus …), dem empfehlen wir das manuelle Update besonders.

Ab v2025.12.3 ist der Fehler behoben, und alle weiteren Updates laufen wieder normal.

Technischer Hintergrund

Für alle, die es genau wissen wollen: Der Deadlock steckt im ELP-Metrik-Worker von B.A.T.M.A.N. V. Beim Abbau einer WLAN-Mesh-Schnittstelle wird der Worker unter gehaltenem RTNL-Lock per cancel_delayed_work_sync() beendet - während der Worker selbst gerade auf rtnl_lock() wartet. Beide warten aufeinander, für immer. Das throughput_override aus der Anleitung sorgt dafür, dass der Worker die betroffene Code-Stelle gar nicht erst erreicht. Details stehen in unserem Issue #776 und im Kernel-Commit.

Vielen Dank an alle, die im Januar Logs und Hinweise beigesteuert haben, an Sören Skaarup für das Testen sowie an Sven Eckelmann vom batman-adv-Projekt für den schnellen Fix. Aus einer Fehlermeldung der Community ist so ein Patch im offiziellen Linux-Kernel entstanden.

Bei Fragen oder Problemen meldet euch gerne im Firmware-Channel.

Viele Grüße Euer Freifunk München Team