Meshtastic ist ein einzigartiges Open-Source-Projekt, das es Menschen ermöglicht, kurze Textnachrichten ohne Internet oder Mobilfunk auszutauschen. Besonders nützlich ist es in Bergen, Wäldern und abgelegenen Gebieten.
MeshCenter im Docker-Container: Meshtastic-Basisstation auf dem Heim-NAS ohne Raspberry Pi
Letzte Aktualisierung: 20.10.2026 (gilt für MeshCenter 1.12.1)
Autor: Konstantin Vinogradov (FlintUA)
💡 MeshCenter ist nicht mehr an den Raspberry Pi gebunden: Seit Version 1.11.0 läuft es auch in einem Docker-Container auf dem heimischen NAS oder Server – das Meshtastic-Funkgerät wird per WLAN angebunden.
💬 Als ich mit MeshCenter angefangen habe, war alles einfach: ein Raspberry Pi, das Funkgerät per USB, die Weboberfläche im Browser. Aber bei mir zu Hause läuft rund um die Uhr ein Synology-NAS, und der Gedanke „Wozu noch eine Platine, wenn das NAS ohnehin läuft?“ ließ mich nicht los. Außerdem wollte ich das Funkgerät dort aufstellen, wo der Empfang am besten ist – und nicht dort, wo der Computer steht.
So entstand der Servermodus: MeshCenter im Docker-Container auf dem NAS, das WLAN-Funkgerät auf dem Dachboden oder am Fenster, dazwischen nur das Heimnetz. In diesem Artikel erkläre ich, wozu das gut ist, was Sie gewinnen und worauf Sie verzichten – und in der zweiten Hälfte zeige ich Schritt für Schritt die Installation, auch wenn Sie noch nie mit Docker gearbeitet haben.
Probieren Sie es selbst aus: interaktive Online-Demo
Wie MeshCenter aussieht, können Sie direkt im Browser ausprobieren, ohne etwas zu installieren: MeshCenter Online-Demo. Die Oberfläche der Docker-Version ist identisch.
🎯 Warum MeshCenter im Container betreiben?
Eine Meshtastic-Basisstation soll dauerhaft laufen: Nachrichten empfangen, während Sie schlafen, Telemetrie sammeln, den Chatverlauf speichern. Üblicherweise nimmt man dafür einen Raspberry Pi. Aber nicht jeder möchte noch ein Gerät anschaffen und pflegen:
- 🗄️ viele haben zu Hause bereits ein NAS, das ohnehin rund um die Uhr läuft – mit RAID, Backups und oft mit USV;
- 🍓 ein Raspberry Pi will separat gepflegt werden: SD-Karte, Netzteil, Systemupdates;
- 📡 das Funkgerät steht am besten dort, wo der Empfang gut ist – auf dem Dachboden, am Fenster, am Mast – und nicht neben dem Computer.
Die Lösung ist einfach: Das Meshtastic-Funkgerät mit WLAN hängt im Heimnetz, MeshCenter läuft im Container auf dem NAS und spricht über das Netzwerk (TCP) mit dem Funkgerät. Ein separater Computer neben dem Funkgerät ist nicht nötig – das Funkgerät braucht nur Strom.
[ Meshtastic-Funkgerät ] ── WLAN ── [ Router ] ── LAN ── [ NAS: MeshCenter-Container ]
(Dachboden / Mast) │
Browser auf PC, Tablet, Smartphone✅ Für wen eignet sich der Servermodus?
- 🗄️ für Besitzer eines Synology- oder anderen NAS mit Intel/AMD-Prozessor;
- 🖥️ für alle mit einem Heimserver oder Mini-PC mit Docker;
- 💾 für alle, denen zentrale Backups wichtig sind und die keine separate Platine pflegen möchten;
- 📡 wenn das Funkgerät räumlich getrennt vom Computer stehen soll.
🍓 Wer besser beim Raspberry Pi bleibt
- 📷 wer Kamera, E-Paper-Display oder Sensoren (BME280, DS3231-Uhr) braucht;
- 🔌 wenn das Funkgerät kein WLAN hat – z. B. nRF52-Boards (RAK4631, T-Echo);
- 📱 wenn das Smartphone mit dem Funkgerät verbunden bleiben soll, während MeshCenter läuft (mehr dazu unten);
- ⚡ wer die einfachste Installation möchte: SD-Karte beschreiben und einschalten.
💡 Es gibt noch eine dritte Variante. Auf jedem Computer oder Server mit Debian/Ubuntu lässt sich MeshCenter auch ohne Docker über die normale manuelle Installation (install.sh) einrichten. Das Funkgerät wird dann per USB angeschlossen, und alle Funktionen stehen zur Verfügung. Docker ist also nicht der einzige Weg ohne Raspberry Pi, sondern die Variante speziell für NAS und Server, auf denen man keine Software direkt ins System installieren möchte.
⚖️ Raspberry Pi oder Docker: der Vergleich
| Raspberry Pi (klassisch) | Docker (Servermodus) | |
|---|---|---|
| Wo es läuft | eigene Pi-Platine | NAS oder Server, den Sie schon haben |
| Anbindung des Funkgeräts | USB (empfohlen), TCP, Bluetooth | nur TCP über das Netzwerk |
| Kamera, Display, Sensoren | ja | nein |
| Installation | automatisch von der SD-Karte | Image bauen + Compose |
| Update | per Knopf in der Oberfläche | durch Austausch des Images |
| Prozessor | ARM (Pi Zero 2W, 3, 4, 5) | x86-64 (Intel/AMD) |
| Datenspeicher | SD-Karte | NAS-Volume (RAID, Snapshots, Backups) |
🏗️ So funktioniert es intern
Für alle, die wissen wollen, was in der „Kiste“ steckt. Das Image basiert auf python:3.11-slim (Debian) und ist etwa 350 MB groß (komprimiert etwa 80 MB).
- 🧠 MeshCenter Core – Flask-Webanwendung unter gunicorn, immer genau ein Worker-Prozess;
- 📡 Meshtastic-Adapter – ein eigener Prozess mit eigener Python-Umgebung und der offiziellen
meshtastic-Bibliothek. Er kommuniziert mit Core über einen lokalen Kanal. So bleibt die GPLv3-Bibliothek vom MIT-lizenzierten Hauptcode getrennt – genau wie bei der normalen Installation; - ⚙️
tinials Init-Prozess – leitet Signale korrekt weiter und hinterlässt keine „Zombies“; - 🔒 normaler Benutzer statt root, alle Capabilities entzogen, Rechteausweitung verboten;
- 🩺 Endpunkt
/healthz– daran erkennt Docker, dass die Webanwendung läuft.
💾 Wo die Daten liegen
Alles Wichtige liegt außerhalb des Containers, in zwei Ordnern auf dem NAS:
| Ordner auf dem NAS | Im Container | Inhalt |
|---|---|---|
config/ | /config | config.py (wird beim ersten Start angelegt und nie überschrieben), Schlüssel der Wetterdienste |
data/ | /data | Nachrichten, Knoten, Funkprofile, Kartenpunkte, MCAttach-Dateien, Einstellungen, Passwort-Hash, Ereignisprotokoll |
Der Container kann gelöscht und neu erstellt, das Image aktualisiert oder zurückgerollt werden – die Daten bleiben erhalten.
🧭 Woran MeshCenter erkennt, dass es im Container läuft
Eine spezielle Umgebungsvariable schaltet den Container-Modus ein. Funktionen, die Hardware benötigen (USB, Kamera, Display, WLAN), lehnt der Server ab, und die Oberfläche blendet sie aus. Die Systemseite zeigt nur ehrliche Werte: Last, Arbeitsspeicher und Laufzeit des Hosts (der Container teilt sie mit dem NAS) sowie den Speicherplatz des Daten-Volumes. Platinenmodell und CPU-Temperatur kann der Container nicht zuverlässig ermitteln – deshalb werden sie ausgeblendet.
⏰ Uhrzeit. Ein Container kann nicht selbst prüfen, ob die Uhr synchronisiert ist. Die Variable MESHCENTER_TRUST_HOST_CLOCK=1 erlaubt, der Uhr des Hosts zu vertrauen – DSM synchronisiert sie per NTP. Davon hängen Zeitpläne und die Zeitsynchronisation des Funkgeräts ab. Die Zeitzone wird über TZ gesetzt.
📡 Verbindung über TCP: was Sie wissen sollten
Die Netzwerkverbindung ist der wichtigste Unterschied des Servermodus – und sie hat ihre Eigenheiten.
⚠️ Die Regel „ein Client pro Funkgerät“
Ein Meshtastic-Funkgerät bedient nur eine einzige TCP-Verbindung. Verbindet sich ein neuer Client, trennt das Funkgerät den vorherigen stillschweigend. Können sich beide automatisch neu verbinden, werfen sie sich gegenseitig endlos hinaus – jeder hält nur wenige Sekunden durch.
Das ist keine Theorie. Bei der Entwicklung der Docker-Version habe ich fast zwei Tage mit diesem Problem verbracht. Die Verbindung brach alle paar Minuten ab, und verdächtigt wurden nacheinander die Firmware des Funkgeräts, die TCP-Keepalive-Einstellungen und mein eigener Code. Die Ursache war ärgerlich simpel: Eine zweite MeshCenter-Instanz auf einem anderen Rechner war auf dasselbe Funkgerät eingestellt, und ihre Bibliothek verband sich jede Sekunde nach der Trennung still wieder neu. Sobald der zweite Client weg war, lief die Docker-Version rund 7 Stunden ohne einen einzigen Abbruch.
Daraus ergeben sich praktische Regeln:
- 🚫 solange MeshCenter verbunden ist, nicht über das Netzwerk mit diesem Funkgerät verbinden – weder mit dem Smartphone noch mit einem zweiten MeshCenter oder einem Skript;
- 📱 Smartphone nötig? Im Node Manager „Funkgerät freigeben“ drücken, mit dem Smartphone arbeiten, in der App trennen und „Neu verbinden“ drücken (mehr dazu unten);
- 🔁 haben mehrere MeshCenter-Installationen ein TCP-Profil für dieses Funkgerät, muss es bei allen außer einer freigegeben sein.
MeshCenter erkennt diese Situation selbst. Seit Version 1.12.0 bemerkt es nicht nur schnelle Abbrüche, sondern auch regelmäßiges Abwechseln, bei dem sich zwei Clients etwa alle halbe bis ganze Minute gegenseitig verdrängen. Im Node Manager erscheint dann der Hinweis, dass das Funkgerät die Sitzung immer wieder beendet und vermutlich ein anderer Client es nutzt, verbunden mit der Empfehlung, es dort freizugeben. Die Verbindungsversuche werden seltener (alle 5, später alle 10 Minuten), um nicht zu stören. Der Hinweis verschwindet von selbst, sobald eine Sitzung 15 Minuten stabil läuft. Selbst gibt MeshCenter das Funkgerät nie frei – diese Entscheidung bleibt bei Ihnen.
📶 WLAN und Bluetooth. Wie die Meshtastic-Dokumentation bestätigt, funktionieren WLAN und Bluetooth auf ESP32-Boards nicht gleichzeitig: Wird WLAN aktiviert, schaltet sich Bluetooth ab. Ein Smartphone „parallel per Bluetooth“ zu verbinden, während MeshCenter über das Netzwerk arbeitet, ist daher nicht möglich.
🔄 Automatische Wiederherstellung der Verbindung
Fällt das Funkgerät weg – Stromausfall, WLAN weg, Router oder NAS neu gestartet -, gibt MeshCenter nicht auf und braucht keinen Neustart:
- ⏳ es wartet etwa 25 Sekunden, damit das Funkgerät die alte Verbindung freigeben kann;
- 🔁 versucht es erneut nach 30, 60, 90 Sekunden und danach alle 2 Minuten – ohne zeitliche Begrenzung;
- 🪪 prüft bei jedem Versuch, ob sich dasselbe Funkgerät meldet – ein anderes Gerät unter derselben IP wird ohne Ihre Bestätigung nicht akzeptiert;
- ⏱️ gilt die Verbindung erst als wiederhergestellt, wenn die Sitzung 20 Sekunden stabil war.
In der Oberfläche erscheint das als „Reconnecting… (attempt N, next in X s)“, und der Knopf Reconnect startet sofort einen Versuch. Der Node Manager zeigt die Zahl der Abbrüche in der letzten Stunde – kurze Aussetzer werden so nicht zum roten Alarmstatus.
Am echten Funkgerät getestet: Nach mehr als 20 Minuten ohne Strom stellte sich die Verbindung von selbst wieder her, ohne Neustart des Containers. Eine Eigenheit des T-Beam: Direkt nach dem Wiederverbinden schließt er manchmal die erste neue Sitzung, der zweite Versuch ist dann stabil. Ein einzelner „Abbruch“ im Zähler nach „Neu verbinden“ ist also normal. Und um das Funkgerät zu schonen, fordert MeshCenter beim Wiederverbinden nur die Konfiguration ohne die vollständige Knotenliste an – etwa 1,2 KB statt 14 KB. Schwächeren ESP32-Boards tut das spürbar gut.
✔️ Zustellbestätigungen
Seit Version 1.12.0 funktionieren Zustellbestätigungen für Direktnachrichten („zugestellt ✓✓“) auch über TCP, nicht nur per USB. Eine Nachricht gilt nur dann als zugestellt, wenn die Bestätigung vom Empfänger selbst kommt und nicht von einem Repeater unterwegs.
✅ Vorteile
- ✅ Kein zusätzliches Gerät – MeshCenter läuft auf dem NAS, das ohnehin rund um die Uhr eingeschaltet ist.
- ✅ Zuverlässige Datenhaltung – die Daten liegen auf dem NAS-Volume mit RAID, Snapshots und Hyper Backup; keine SD-Karte, die verschleißt oder bei Stromausfall beschädigt wird.
- ✅ Freie Wahl des Standorts – das Funkgerät steht dort, wo der Empfang am besten ist; es braucht nur Strom und WLAN.
- ✅ Isolation und Sicherheit – der Container läuft nicht als root, ohne überflüssige Rechte, und lässt das NAS-System unangetastet.
- ✅ Einfaches Update und Rollback – neue Version = neues Image; gefällt sie nicht, nimmt man das alte zurück.
- ✅ Bequeme Übergabe des Funkgeräts – „Funkgerät freigeben“ überlässt es dem Smartphone für die gewünschte Zeit, ohne den Container zu stoppen.
- ✅ Leistung – der Prozessor eines NAS ist meist stärker als ein Raspberry Pi Zero 2W, die Oberfläche reagiert schneller.
⚠️ Einschränkungen
- 📡 Nur TCP – das Funkgerät braucht WLAN (oder Ethernet) und aktivierten Netzwerkzugriff. USB und Bluetooth sind im Container deaktiviert.
- 🖥️ Nur x86-64 – das Image wird für
linux/amd64gebaut. ARM-NAS und der Raspberry Pi werden in Docker derzeit nicht unterstützt. - 🔒 Ein Client pro Funkgerät – solange MeshCenter verbunden ist, können sich Smartphone und andere Programme nicht über das Netzwerk verbinden. Für die Übergabe gibt es „Funkgerät freigeben“.
- 📷 Keine hardwarebezogenen Funktionen – Kamera, E-Paper-Display, I2C-Sensoren und RTC, WLAN-Verwaltung, Neustart des Geräts.
- 🔄 Kein eingebautes Update – die Update-Schaltfläche ist im Container deaktiviert, eine neue Version wird als neues Image gebaut und geladen.
- 📦 Kein fertiges Image – es muss selbst gebaut werden (einmal pro Version).
- 📭 Nachrichten während eines Abbruchs können verloren gehen – das Funkgerät puffert sie nicht für einen Netzwerk-Client.
- 🧪 Bisher nur auf Synology DS920+ getestet – auf anderen Systemen sollte es nach demselben Prinzip funktionieren, offiziell getestet sind sie aber noch nicht.
🔒 Sicherheit
- 🔑 Beim ersten Start verlangt MeshCenter ein Passwort (mindestens 12 Zeichen). Legen Sie es sofort fest: Solange kein Passwort existiert, könnte jeder in Ihrem Netz die Installation „übernehmen“.
- 🛡️ Alle Seiten und die API sind sitzungsgeschützt, ändernde Anfragen zusätzlich per CSRF-Token; wiederholte Fehlanmeldungen werden gebremst.
- 🌐 MeshCenter arbeitet mit einfachem HTTP und ist für das Heimnetz gedacht. Geben Sie den Port nicht ins Internet frei – für Fernzugriff nutzen Sie ein VPN oder einen Reverse Proxy mit HTTPS.
- 📁 Der Ordner
data/enthält Geheimnisse (Passwort-Hash, Sitzungsschlüssel, MCAttach-Schlüssel) – machen Sie ihn nicht öffentlich zugänglich.
🛠️ Schritt-für-Schritt-Installation auf Synology
Jetzt zur Praxis. Ich beschreibe die Installation auf einer Synology DS920+ (DSM 7.3) – darauf ist alles getestet. Bei anderen Systemen unterscheiden sich nur die Menübezeichnungen (dazu weiter unten).
📚 Ein paar Begriffe
- 📦 Image – die fertige „Kiste“ mit dem Programm: darin ein minimales Linux, Python, MeshCenter und die meshtastic-Bibliothek. Wird einmal gebaut und ändert sich nicht.
- ▶️ Container – eine laufende Instanz des Images. Er lässt sich stoppen, löschen und neu erstellen, ohne dass etwas verloren geht.
- 📁 Ordner außerhalb (Volumes) –
config/unddata/auf dem NAS. Dort liegen alle Ihre Daten. - 📝 compose.yaml – eine Textdatei als „Rezept“: welches Image gestartet wird, auf welchem Port und welche Ordner eingebunden werden.
📋 Was Sie vorab brauchen
- 🖥️ Ein NAS mit Intel/AMD-Prozessor. Prüfen auf Synology: Systemsteuerung → Infocenter → Allgemein → Prozessor.
- 📦 Container Manager: Paket-Zentrum → Container Manager → Installieren.
- 📡 Ein Meshtastic-Funkgerät mit WLAN. Aktivieren Sie in der offiziellen App das WLAN, verbinden Sie das Funkgerät mit dem Heimnetz und stellen Sie sicher, dass der Netzwerkzugriff (TCP, Port 4403) aktiv ist.
- 📌 Eine feste IP für das Funkgerät. Reservieren Sie die Adresse im Router (DHCP-Reservierung) – sonst findet MeshCenter das Funkgerät nach einem Adresswechsel nicht mehr.
- 💻 Einen Computer zum Bauen des Images mit Windows, macOS oder Linux, auf dem Docker Desktop und Git installiert werden können.
💻 Schritt 1: Image auf dem Computer bauen
Ein fertiges Image zum Herunterladen gibt es noch nicht (warum, steht in den Fragen und Antworten). Es zu bauen ist aber nicht schwer. Installieren Sie Docker Desktop und Git, laden Sie den Quellcode herunter und wechseln Sie auf ein Release – wirklich auf ein Release, nicht auf den aktuellen Entwicklungsstand:
git clone https://github.com/FlintUA/MeshCenter
cd MeshCenter
git checkout v1.12.1Die aktuelle Versionsnummer finden Sie unter Releases. Bauen Sie nun das Image. Linux / macOS:
deploy/docker/build.shWindows (PowerShell) – der Befehl komplett, mit dem Punkt am Ende:
docker build --platform linux/amd64 --build-arg MESHCENTER_VERSION=1.12.1 -t meshcenter:1.12.1 .Der Build dauert einige Minuten. Speichern Sie das Image anschließend als Datei, um es auf das NAS zu übertragen:
docker save -o meshcenter-1.12.1.tar meshcenter:1.12.1💡 Die Datei ist etwa 80-90 MB groß. Das Image lässt sich auch direkt auf dem NAS aus dem Quellcode bauen, dafür braucht man aber Git und SSH, und auf dem NAS dauert es deutlich länger. Für Einsteiger ist der Weg über den Computer einfacher.
📁 Schritt 2: Ordner und Berechtigungen
Legen Sie in der File Station den Ordner /volume2/docker/meshcenter/ an und darin zwei Ordner: config und data. Liegt Ihr freigegebener Ordner docker auf dem ersten Volume, schreiben Sie volume1 (hier und im Folgenden).
[📷 Platz für Screenshot: File Station mit den Ordnern config und data]
Aus Sicherheitsgründen läuft der Container nicht als Administrator, sondern als normaler Benutzer – und dieser braucht Schreibrechte für die beiden Ordner. Dafür benötigen Sie SSH:
- SSH aktivieren: Systemsteuerung → Terminal & SNMP → SSH-Dienst aktivieren;
- vom Computer aus verbinden (unter Windows in PowerShell):
ssh ihr_benutzer@IP-des-NAS; sudo -iausführen (das System fragt nach dem DSM-Passwort).
Geben Sie die Befehle anschließend einzeln ein. Ermitteln Sie zuerst die numerischen IDs des Benutzers:
id ihr_benutzerDie Antwort sieht etwa so aus: uid=1026(...) gid=100(users). Die Zahl nach uid ist die PUID, die nach gid die PGID. Übergeben Sie die Ordner diesem Benutzer (Ihre Zahlen einsetzen):
chown -R 1026:100 /volume2/docker/meshcenter/config /volume2/docker/meshcenter/data💡 Das Image ist standardmäßig auf 1026:100 ausgelegt – der erste angelegte Synology-Benutzer hat meist genau diese Werte. Haben Sie andere Zahlen, tragen Sie sie in die compose.yaml ein (Schritt 4).
📦 Schritt 3: Image auf das NAS laden
Ohne Kommandozeile: Container Manager → Image → Importieren → Aus Datei hinzufügen → meshcenter-1.12.1.tar auswählen. Nimmt die Oberfläche die Datei nicht an, verwenden Sie den Weg per SSH unten.
[📷 Platz für Screenshot: Container Manager → Image → Importieren]
Oder per SSH: Kopieren Sie die Datei über die File Station auf das NAS und führen Sie aus:
docker load -i /volume2/docker/meshcenter/meshcenter-1.12.1.tarDanach erscheint das Image meshcenter:1.12.1 in der Image-Liste, und die .tar-Datei kann gelöscht werden.
📝 Schritt 4: Die Datei compose.yaml
Legen Sie im Ordner /volume2/docker/meshcenter/ eine Textdatei compose.yaml mit folgendem Inhalt an:
name: meshcenter
services:
meshcenter:
container_name: meshcenter
image: meshcenter:1.12.1
user: "1026:100" # PUID:PGID aus Schritt 2
restart: unless-stopped
ports:
- "5080:5000" # Port 5000 belegt auf Synology DSM selbst
environment:
TZ: Europe/Berlin # Ihre Zeitzone
MESHCENTER_TRUST_HOST_CLOCK: "1"
volumes:
- ./config:/config
- ./data:/data
hostname: meshcenter
cap_drop: [ALL]
security_opt: ["no-new-privileges:true"]
stop_grace_period: 30simage– Name und Version des Images aus Schritt 3, mit Doppelpunkt (meshcenter:1.12.1), nicht der Name der tar-Datei;ports: "5080:5000"– MeshCenter ist über Port 5080 des NAS erreichbar;MESHCENTER_TRUST_HOST_CLOCK– der NAS-Uhr vertrauen; ohne diese Einstellung funktionieren Zeitpläne und die Zeitsynchronisation des Funkgeräts nicht;cap_dropundno-new-privileges– der Container erhält keine überflüssigen Rechte.
🚀 Schritt 5: Starten
Container Manager → Projekt → Erstellen: Name meshcenter, Pfad /volume2/docker/meshcenter, Quelle „vorhandene compose.yaml verwenden“, weiter – fertig.
[📷 Platz für Screenshot: Container Manager → Projekt → Erstellen]
Per SSH geht es so:
cd /volume2/docker/meshcenter
docker compose up -d🔑 Schritt 6: Erste Anmeldung und Einrichtung
- Öffnen Sie im Browser
http://IP-des-NAS:5080. Der erste Start kann bis zu einer Minute dauern. - Es erscheint die Ersteinrichtung – legen Sie sofort ein Passwort fest.
- Öffnen Sie den Node Manager, wählen Sie die Suche per TCP, geben Sie die IP des Funkgeräts und den Port
4403ein und bestätigen Sie. MeshCenter startet sich selbst neu. - Für die Dateiübertragung (MCAttach) geben Sie die Nummer Ihres privaten Kanals an: Öffnen Sie
config/config.pyund setzen SieMCA_CONTROL_CHANNEL_INDEX = 1(die Nummer ist die Position des Kanals in der Meshtastic-App: 0 – Primärkanal, 1 – erster Sekundärkanal usw.). Starten Sie das Projekt danach neu.
[📷 Platz für Screenshot: Node Manager: Funkgerät per TCP verbinden]
🔒 Wichtig: MeshCenter verwendet für die Steuerdaten von MCAttach bewusst nicht den öffentlichen Kanal – deshalb ist die Dateiübertragung ohne diese Einstellung deaktiviert.
🔄 Im Alltag
- 📱 Funkgerät für das Smartphone freigeben – Node Manager → „Funkgerät freigeben“ → Dauer → „Freigeben“. Mit dem Smartphone arbeiten, in der App trennen und „Neu verbinden“ drücken (oder das Ende der Dauer abwarten). Das Projekt im Container Manager zu stoppen funktioniert auch, die Schaltfläche ist aber bequemer.
- 🌙 NAS herunterfahren – den Container müssen Sie nicht manuell stoppen: Nach dem Hochfahren startet er von selbst. Ein manuell gestoppter Container bleibt nach einem Neustart dagegen aus. Und denken Sie daran: War das Funkgerät vor dem Ausschalten „bis zum erneuten Verbinden“ freigegeben, drücken Sie nach dem Einschalten „Neu verbinden“.
- ⬆️ Update – auf dem Computer ein neues Image bauen (
git checkoutauf die neue Version, Build,docker save), importieren, die Version in der Zeileimage:ändern und das Projekt neu starten. Danach die Seite mit Strg+F5 neu laden und unten die Version prüfen. Die Datenordner bleiben unberührt. - ↩️ Rollback – die vorherige Version in
image:eintragen, sofern das alte Image noch in der Liste ist. - 💾 Backup – Projekt stoppen,
config/unddata/kopieren (z. B. mit Hyper Backup), wieder starten. Daten eines laufenden Containers sollte man nicht kopieren: Darin liegen SQLite-Datenbanken. - 📜 Logs – Container Manager → Container → meshcenter → Protokoll oder
docker compose logs -f.
🗄️ Andere NAS und normale Linux-Server
Der Ablauf ist überall gleich: Image bauen → laden → Ordner config und data mit Berechtigungen → compose.yaml → starten. Es unterscheiden sich nur die Menübezeichnungen:
- 📦 QNAP – Container Station → Images → Import, danach Applications → Create mit derselben
compose.yaml; - 📦 Unraid – Plugin Compose Manager oder Container manuell mit denselben Port- und Ordnerangaben anlegen;
- 📦 TrueNAS SCALE – Apps → Custom App;
- 🐧 Debian/Ubuntu-Server –
dockerunddocker composeinstallieren, Ordner anlegen,chownausführen,compose.yamlablegen unddocker compose up -dstarten.
Diese Systeme sind noch nicht getestet. Die Voraussetzungen sind überall dieselben: x86-64-Prozessor und Funkgerät mit TCP-Zugriff.
🩺 Häufige Fehler
| Was Sie sehen | Ursache und Lösung |
|---|---|
| Container stoppt sofort, im Protokoll „not writable“ | Falsche Berechtigungen auf config/ oder data/ – Schritt 2 wiederholen und user: prüfen |
| Seite öffnet sich nicht auf Port 5000 | Auf Synology belegt DSM den Port 5000 – 5080:5000 verwenden |
| Funkgerät verbindet sich und fällt wieder ab | Ein zweiter Client ist verbunden: Smartphone, anderes MeshCenter, Programm auf dem PC |
| Hinweis „Das Funkgerät beendet unsere Sitzung immer wieder…“ | Das Funkgerät ist von einem anderen Client belegt – dort freigeben oder das Smartphone trennen |
| Nach einem NAS-Neustart Status „Freigegeben“ | Das Funkgerät war „bis zum erneuten Verbinden“ freigegeben – im Node Manager „Neu verbinden“ drücken |
| Ein einzelner Abbruch direkt nach „Neu verbinden“ | Beim T-Beam normal: Die erste Sitzung nach dem Wiederverbinden wird manchmal geschlossen, die zweite ist stabil |
| „Reconnecting…“ hängt lange | Funkgerät aus, nicht im Netz oder neue IP – DHCP-Reservierung im Router prüfen |
docker compose up meldet „pull access denied“ | Das Image ist noch nicht geladen (docker load) oder in der Zeile image: steht ein Tippfehler, z. B. der Dateiname statt meshcenter:1.12.1 |
Nachricht „unbestätigt“, Antwort NO_CHANNEL | Der Empfänger kann die Nachricht nicht entschlüsseln: kein Schlüsselaustausch zwischen den Funkgeräten |
| MCAttach: „control channel index None“ | MCA_CONTROL_CHANNEL_INDEX nicht gesetzt (Schritt 6) |
| Zeitpläne lösen nicht aus | MESHCENTER_TRUST_HOST_CLOCK und die NAS-Uhrzeit prüfen |
| Falsche Uhrzeit | Falsches TZ in der compose.yaml |
| „not available in a container“ | Die Funktion braucht Hardware – im Container nicht verfügbar |
❓ Fragen und Antworten
Läuft die Docker-Version auf dem Raspberry Pi?
Noch nicht – das Image wird nur für x86-64 gebaut. Für den Raspberry Pi gibt es die normale Installation, und die kann mehr: USB, Kamera, Display, Sensoren.
Und unter Windows oder macOS mit Docker Desktop?
In der Entwicklung hat das funktioniert, offiziell unterstützt wird es aber nicht: Docker Desktop ist für die Entwicklung gedacht, nicht für den Dauerbetrieb. Für eine dauerhafte Station nehmen Sie ein NAS oder einen Linux-Server.
Kann ich das Funkgerät per USB ans NAS hängen und in den Container durchreichen?
In der aktuellen Version nicht. Hängt das Funkgerät per USB an einem Linux-Rechner, ist es einfacher, MeshCenter direkt auf diesem Rechner zu installieren – ohne Docker.
Was passiert, wenn das NAS nachts abgeschaltet wird?
Nichts Schlimmes: Der Container stoppt mit dem NAS und startet nach dem Einschalten wieder. Nachrichten, die eintreffen, während das NAS aus ist, sieht MeshCenter allerdings nicht.
Kann ich zwei MeshCenter an einem Funkgerät betreiben?
Gleichzeitig über TCP – nein, sie werfen sich gegenseitig hinaus. Mit „Funkgerät freigeben“ lassen sie sich aber problemlos abwechseln: Bei der einen Installation ist das Funkgerät „bis zum erneuten Verbinden“ freigegeben, bei der anderen verbunden. Alternativ ein Raspberry Pi mit einem Funkgerät per USB und das NAS mit einem anderen Funkgerät per TCP.
Wie verbinde ich mich vorübergehend per Smartphone mit dem Funkgerät?
Im Node Manager „Funkgerät freigeben“ drücken und die Dauer wählen. Mit der Meshtastic-App per WLAN verbinden, das Nötige erledigen, in der App trennen und „Neu verbinden“ drücken. Bei 15 Minuten oder einer Stunde verbindet sich MeshCenter danach von selbst wieder.
Warum gibt es kein fertiges Image auf Docker Hub?
Im Image steckt die Bibliothek meshtastic unter der GPLv3. Für die Verteilung fertiger Images braucht es eine entsprechende Dokumentation zu Quellcode und Lizenzen, und die ist noch nicht fertig. Bis dahin bitte ich darum, das Image selbst für den privaten Gebrauch zu bauen und keine fertigen Images zu veröffentlichen.
Woran erkenne ich, dass der Container ordnungsgemäß läuft?
Im Container Manager hat der Container den Status healthy – die Webanwendung antwortet. Den Zustand der Verbindung zum Funkgerät zeigt die Oberfläche selbst: das Symbol in der Kopfzeile und der Node Manager.
💎 Fazit
Die Docker-Version von MeshCenter ist ein Servermodus für alle, die bereits ein NAS oder einen Heimserver haben und ihr WLAN-Funkgerät an einem günstigen Ort aufstellen können. Sie erhalten zuverlässige Datenhaltung, Isolation, einfache Updates und kommen ohne zusätzliches Gerät aus. Im Gegenzug entfallen die hardwarebezogenen Funktionen, und die Regel „eine Netzwerkverbindung pro Funkgerät“ muss eingehalten werden.
Brauchen Sie eine vollwertige Station mit allen Funktionen, nehmen Sie den Raspberry Pi mit USB-Funkgerät. Ist Ihnen „einrichten und vergessen“ auf dem ohnehin laufenden NAS wichtiger, ist der Servermodus das Richtige.
🔨 Aktueller Stand
- ✅ die Docker-Version ist seit Version 1.11.0 Teil von MeshCenter;
- ✅ getestet auf Synology DS920+ mit T-Beam: stundenlanger Betrieb ohne Abbrüche, automatische Wiederherstellung nach Ausfall des Funkgeräts;
- ✅ 1.12.0: Zustellbestätigungen über TCP, „Funkgerät freigeben“, Erkennung eines zweiten Clients;
- ✅ 1.12.1: ausführliche englischsprachige Docker-Anleitung im Repository, App-eigene Dialoge statt Browser-Systemdialogen;
- 💭 geplant: ein Image für ARM und fertige Images, sobald die Lizenzfragen geklärt sind.
Wenn Sie den Servermodus auf einem anderen NAS ausprobieren – QNAP, Unraid, TrueNAS -, berichten Sie gern in den Issues auf GitHub: Das hilft dem Projekt sehr. 📡
🔗 Links
- 📦 Quellcode: github.com/FlintUA/MeshCenter
- 📘 Docker-Anleitung (englisch): docs/Docker_Installation.md
- 🌐 Online-Demo: meshcenter.elektroniker.help/preview
- 📖 Der erste Artikel zum Projekt: MeshCenter: Die Entstehungsgeschichte eines Steuerzentrums für Meshtastic
- 📡 Offizielle Meshtastic-Website: meshtastic.org
Autor: Konstantin Vinogradov (FlintUA)
Elektroniker, Meshtastic-Enthusiast, Raspberry-Pi- und DIY-Projekt-Liebhaber.