Reticulum Benutzerhandbuch - Installation

Aus AutarkWiki
Version vom 21. November 2026, 08:52 Uhr von Andre Pohle (Diskussion | Beiträge) (Schützte „Reticulum Benutzerhandbuch - Installation“ ([Bearbeiten=Nur automatisch bestätigten Benutzern erlauben] (unbeschränkt) [Verschieben=Nur automatisch bestätigten Benutzern erlauben] (unbeschränkt)))
Zur Navigation springen Zur Suche springen

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