Reticulum Benutzerhandbuch - Installation: Unterschied zwischen den Versionen
K (Schützte „Reticulum Benutzerhandbuch - Installation“ ([Bearbeiten=Nur automatisch bestätigten Benutzern erlauben] (unbeschränkt) [Verschieben=Nur automatisch bestätigten Benutzern erlauben] (unbeschränkt))) |
|||
| (3 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| + | [[Kategorie:Digitale Autarkie]] | ||
| + | [[Kategorie:Kommunikation]] | ||
| + | [[Kategorie:Reticulum Handbuch]] | ||
| + | [[Datei:Reticulum logo 512.png|512px|rechts|Quelle: https://reticulum.network/index_de.html]] | ||
| + | ==[[Digitale Autarkie in der Praxis]]== | ||
| + | '''[[Digitale_Autarkie_in_der_Praxis#Kommunikation|Kommunikation]]''' | ||
| + | ├─ [[Wie funktioniert Meshtastic]] | ||
| + | | └─ [[Digitale Kommunikation mit Meshtastic]] | ||
| + | | └─ [[CB Datenfunk]] | ||
| + | └─ [[Reticulum Network Stack (RNS)]] | ||
| + | └─ [[Reticulum Benutzerhandbuch - Einführung]] | ||
==Reticulum Benutzerhandbuch – Kapitel 3: Installation & Grundkonfiguration== | ==Reticulum Benutzerhandbuch – Kapitel 3: Installation & Grundkonfiguration== | ||
| Zeile 97: | Zeile 108: | ||
type = RNodeInterface | type = RNodeInterface | ||
interface_enabled = True | interface_enabled = True | ||
| + | outgoing = True | ||
| + | port = /dev/ttyUSB0 | ||
| + | frequency = 869525000 | ||
| + | bandwidth = 125000 | ||
| + | txpower = 14 | ||
| + | spreadingfactor = 8 | ||
| + | codingrate = 5 | ||
| + | </pre> | ||
| + | |||
| + | ''Praxis-Tipp für dauerhafte USB-Zuordnung:'' Wenn mehrere USB-Geräte am Raspberry Pi hängen, kann sich <code>ttyUSB0</code> nach einem Neustart auf <code>ttyUSB1</code> verschieben. Über den Pfad unter <code>/dev/serial/by-id/...</code> (abrufbar mit <code>ls -l /dev/serial/by-id/</code>) weist du jedem Funkboard eine unverwechselbare Hardware-Adresse zu. | ||
| + | |||
| + | === Optional: Brücke über das Internet (<code>TCPClientInterface</code>) === | ||
| + | Solange noch eine Internetverbindung besteht, kannst du deinen Heim-Knoten über TCP mit anderen Reticulum-Knoten oder öffentlichen Einstiegspunkten verbinden. Fällt das Internet aus, arbeitet das LoRa-Interface trotzdem nahtlos weiter: | ||
| + | <pre> | ||
| + | [[Reticulum Testnet Dublin]] | ||
| + | type = TCPClientInterface | ||
| + | interface_enabled = True | ||
| + | target_host = dublin.connect.reticulum.network | ||
| + | target_port = 4965 | ||
| + | </pre> | ||
| + | ''Hinweis: Für ein rein autarkes, lokales Krisennetz ohne Internetverbindung lässt man diesen Eintrag einfach weg.'' | ||
| + | |||
| + | == Schritt 4: Reticulum automatisch beim Systemstart starten == | ||
| + | Damit dein Knoten nach einem Stromausfall oder Neustart sofort wieder einsatzbereit ist, richten wir einen <code>systemd</code>-Dienst ein. | ||
| + | |||
| + | Erstelle eine neue Dienst-Datei (ersetze <code>DEIN_BENUTZERNAME</code> durch deinen Linux-Benutzernamen, z. B. <code>pi</code>): | ||
| + | <pre> | ||
| + | sudo nano /etc/systemd/system/rnsd.service | ||
| + | </pre> | ||
| + | |||
| + | Füge folgenden Inhalt ein: | ||
| + | <pre> | ||
| + | [Unit] | ||
| + | Description=Reticulum Network Stack Daemon | ||
| + | After=network.target | ||
| + | |||
| + | [Service] | ||
| + | Type=simple | ||
| + | User=DEIN_BENUTZERNAME | ||
| + | ExecStart=/home/DEIN_BENUTZERNAME/.local/bin/rnsd --service | ||
| + | Restart=always | ||
| + | RestartSec=5 | ||
| + | |||
| + | [Install] | ||
| + | WantedBy=multi-user.target | ||
| + | </pre> | ||
| + | |||
| + | Aktiviere und starte den Dienst anschließend: | ||
| + | <pre> | ||
| + | sudo systemctl daemon-reload | ||
| + | sudo systemctl enable rnsd | ||
| + | sudo systemctl start rnsd | ||
| + | </pre> | ||
| + | |||
| + | == Funktionskontrolle == | ||
| + | Mit dem Befehl <code>rnstatus</code> prüfst du jetzt, ob der Hintergrunddienst läuft und dein RNode sauber verbunden ist: | ||
| + | <pre> | ||
| + | rnstatus | ||
| + | </pre> | ||
| + | Erscheint dort dein Interface <code>RNode LoRa 868MHz</code> mit dem Status <code>Up</code>, steht deine Funk-Infrastruktur! | ||
| + | |||
| + | == Nächster Schritt == | ||
| + | Jetzt, da der Hintergrunddienst läuft, schauen wir uns im nächsten Kapitel die Bordwerkzeuge auf der Kommandozeile an – damit du Reichweiten testen, Wege im Netz verfolgen und Dateien per Funk übertragen kannst. | ||
| + | |||
| + | '''Weiter zu: [[Reticulum Benutzerhandbuch - Bordwerkzeuge|Kapitel 4: Die Bordwerkzeuge (CLI)]]''' | ||
| + | |||
| + | [[Kategorie:Digitale Autarkie]] | ||
| + | [[Kategorie:Kommunikation]] | ||
| + | [[Kategorie:Reticulum Handbuch]] | ||
Aktuelle Version vom 21. November 2026, 09:23 Uhr
Inhaltsverzeichnis
- 1 Digitale Autarkie in der Praxis
- 2 Reticulum Benutzerhandbuch – Kapitel 3: Installation & Grundkonfiguration
- 3 Voraussetzungen auf dem Host-Rechner
- 4 Schritt 1: System vorbereiten und Reticulum installieren
- 5 Schritt 2: Der erste Start und die Verzeichnisstruktur
- 6 Schritt 3: Die Konfigurationsdatei verstehen
- 7 Schritt 4: Reticulum automatisch beim Systemstart starten
- 8 Funktionskontrolle
- 9 Nächster Schritt
Digitale Autarkie in der Praxis
Kommunikation ├─ Wie funktioniert Meshtastic | └─ Digitale Kommunikation mit Meshtastic | └─ CB Datenfunk └─ Reticulum Network Stack (RNS) └─ Reticulum Benutzerhandbuch - Einführung
Reticulum Benutzerhandbuch – Kapitel 3: Installation & Grundkonfiguration
| 1. Einführung | 2. Hardware | 3. Installation | 4. Bordwerkzeuge | 5. NomadNet | 6. Micron (.mu) | 7. Solar-Knoten |
Voraussetzungen auf dem Host-Rechner
Reticulum ist in Python geschrieben und läuft extrem ressourcenschonend. Als Host-Rechner eignen sich zum Beispiel:
- Ein Raspberry Pi (ab Pi Zero 2 W, Pi 3, Pi 4 oder Pi 5) mit Raspberry Pi OS (Lite oder Desktop)
- Ein Linux-PC oder Mini-PC (Debian, Ubuntu, Mint, Arch usw.)
- Ein ausrangiertes Android-Smartphone (über die App Sideband oder in einer Termux-Umgebung)
Für dieses Kapitel nutzen wir als Grundlage ein aktuelles Debian / Ubuntu / Raspberry Pi OS.
Schritt 1: System vorbereiten und Reticulum installieren
Moderne Linux-Systeme schützen ihre System-Python-Umgebung vor direkten Änderungen per pip. Der sauberste und empfohlene Weg ist die Installation über pipx. Damit läuft Reticulum isoliert, lässt sich leicht aktualisieren und alle Befehle stehen systemweit im Terminal bereit.
1. Systempakete und pipx installieren
Öffne ein Terminal und führe folgende Befehle aus:
sudo apt update && sudo apt upgrade -y sudo apt install -y python3-pip python3-venv pipx pipx ensurepath
Hinweis: Nach pipx ensurepath das Terminal einmal schließen und neu öffnen (oder source ~/.bashrc ausführen), damit der neue Programmpfad aktiv wird.
2. Reticulum (rns) und RNode-Tools installieren
Jetzt wird das eigentliche Reticulum-Paket (rns) inklusive der Serien-Treiber für USB-Funkmodule installiert:
pipx install rns pipx inject rns pyserial
Ob alles geklappt hat, prüfst du mit:
rnstatus --version
3. Berechtigung für die USB-Schnittstelle setzen
Damit dein Benutzerkonto ohne Root-Rechte (sudo) auf das per USB angeschlossene LoRa-Board zugreifen darf, muss dein Benutzer in der Gruppe dialout sein:
sudo usermod -aG dialout $USER
Damit diese Gruppenänderung greift, einmal ab- und wieder anmelden (oder den Pi neu starten).
Schritt 2: Der erste Start und die Verzeichnisstruktur
Reticulum besteht im Kern aus dem Hintergrunddienst rnsd (Reticulum Network Stack Daemon). Beim allerersten Start legt er automatisch seine Konfigurationsdateien und deine kryptografische Identität an.
Starte den Dienst einmal kurz manuell und beende ihn nach ein paar Sekunden wieder mit Strg + C:
rnsd
Dadurch entsteht in deinem Home-Verzeichnis der versteckte Ordner ~/.reticulum/ mit folgendem Inhalt:
~/.reticulum/config– Die zentrale Konfigurationsdatei für alle Netzwerkschnittstellen (Funk, WLAN, Internet).~/.reticulum/storage/– Hier speichert Reticulum deine Schlüsselpaare, bekannte Routen und zwischengespeicherte Pakete. Wichtig: Diesen Ordner bei Backups unbedingt mitsichern, da hier deine Identität liegt!
Schritt 3: Die Konfigurationsdatei verstehen
Öffne die Konfigurationsdatei mit einem Texteditor (z. B. nano):
nano ~/.reticulum/config
Die Datei ist in klare Abschnitte unterteilt. Oben stehen allgemeine Einstellungen unter [reticulum], darunter unter [interfaces] alle Wege, über die Reticulum Daten senden und empfangen darf.
Wichtige Grundeinstellungen ([reticulum])
[reticulum] # Soll dieser Knoten Daten für andere Teilnehmer weiterleiten? # Für Heim-Knoten und Relais auf "Yes" setzen, für reine Endgeräte "No". enable_transport = Yes # Erlaubt mehreren Programmen (z. B. NomadNet + rncp) die gleichzeitige Nutzung share_instance = Yes
Lokales WLAN/LAN einbinden (AutoInterface)
Standardmäßig ist in der Konfiguration bereits das AutoInterface aktiv. Es sorgt dafür, dass sich alle Reticulum-Geräte im selben lokalen WLAN oder Heimnetzwerk vollautomatisch finden – ganz ohne IP-Konfiguration:
[interfaces]
[[Default Interface]]
type = AutoInterface
enabled = Yes
Den RNode (LoRa-Funkmodul) einbinden
Um dein geflashtes LoRa-Board anzubinden, schließt du es per USB an und ermittelst den Gerätenamen:
ls /dev/ttyUSB* /dev/ttyACM* 2>/dev/null
Meist lautet der Anschluss /dev/ttyUSB0 (z. B. beim Heltec V3 oder T-Beam) oder /dev/ttyACM0 (z. B. beim RAK4631).
Füge nun unter [interfaces] folgenden Block für dein 868-MHz-Funkmodul hinzu:
[[RNode LoRa 868MHz]]
type = RNodeInterface
interface_enabled = True
outgoing = True
port = /dev/ttyUSB0
frequency = 869525000
bandwidth = 125000
txpower = 14
spreadingfactor = 8
codingrate = 5
Praxis-Tipp für dauerhafte USB-Zuordnung: Wenn mehrere USB-Geräte am Raspberry Pi hängen, kann sich ttyUSB0 nach einem Neustart auf ttyUSB1 verschieben. Über den Pfad unter /dev/serial/by-id/... (abrufbar mit ls -l /dev/serial/by-id/) weist du jedem Funkboard eine unverwechselbare Hardware-Adresse zu.
Optional: Brücke über das Internet (TCPClientInterface)
Solange noch eine Internetverbindung besteht, kannst du deinen Heim-Knoten über TCP mit anderen Reticulum-Knoten oder öffentlichen Einstiegspunkten verbinden. Fällt das Internet aus, arbeitet das LoRa-Interface trotzdem nahtlos weiter:
[[Reticulum Testnet Dublin]]
type = TCPClientInterface
interface_enabled = True
target_host = dublin.connect.reticulum.network
target_port = 4965
Hinweis: Für ein rein autarkes, lokales Krisennetz ohne Internetverbindung lässt man diesen Eintrag einfach weg.
Schritt 4: Reticulum automatisch beim Systemstart starten
Damit dein Knoten nach einem Stromausfall oder Neustart sofort wieder einsatzbereit ist, richten wir einen systemd-Dienst ein.
Erstelle eine neue Dienst-Datei (ersetze DEIN_BENUTZERNAME durch deinen Linux-Benutzernamen, z. B. pi):
sudo nano /etc/systemd/system/rnsd.service
Füge folgenden Inhalt ein:
[Unit] Description=Reticulum Network Stack Daemon After=network.target [Service] Type=simple User=DEIN_BENUTZERNAME ExecStart=/home/DEIN_BENUTZERNAME/.local/bin/rnsd --service Restart=always RestartSec=5 [Install] WantedBy=multi-user.target
Aktiviere und starte den Dienst anschließend:
sudo systemctl daemon-reload sudo systemctl enable rnsd sudo systemctl start rnsd
Funktionskontrolle
Mit dem Befehl rnstatus prüfst du jetzt, ob der Hintergrunddienst läuft und dein RNode sauber verbunden ist:
rnstatus
Erscheint dort dein Interface RNode LoRa 868MHz mit dem Status Up, steht deine Funk-Infrastruktur!
Nächster Schritt
Jetzt, da der Hintergrunddienst läuft, schauen wir uns im nächsten Kapitel die Bordwerkzeuge auf der Kommandozeile an – damit du Reichweiten testen, Wege im Netz verfolgen und Dateien per Funk übertragen kannst.
Weiter zu: Kapitel 4: Die Bordwerkzeuge (CLI)
