Reticulum Benutzerhandbuch - Installation
Inhaltsverzeichnis
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