Reticulum Benutzerhandbuch - Installation

Aus AutarkWiki
Zur Navigation springen Zur Suche springen
Quelle: https://reticulum.network/index_de.html

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)