TREK

Beim ersten Start installiert der Seed Docker und startet TREK mit Caddy als Reverse Proxy, der die HTTPS-Verbindungen annimmt und an TREK weiterreicht. Nach zwei bis vier Minuten ist TREK erreichbar. Sobald TREK läuft, finden Sie die Adresse in /root/ready.txt und Ihre Zugangsdaten in /root/trek-credentials.txt. Wenn stattdessen /root/failed.txt erscheint, steht darin der Grund. Das vollständige Protokoll finden Sie in /root/trek-install.log. Solange keine der beiden Dateien da ist, läuft die Einrichtung noch. Sie lesen diese Dateien per SSH oder in der Konsole des Seeds.

Sie melden sich mit der E-Mail-Adresse aus ADMIN_EMAIL und dem Passwort aus /root/trek-credentials.txt an. Bei der ersten Anmeldung legen Sie ein eigenes Passwort fest. Unter Einstellungen > Konto können Sie später Ihre E-Mail-Adresse ändern und die Zwei-Faktor-Anmeldung einschalten.

Nach der Installation ist die Registrierung geschlossen. Unter Admin > Benutzer erstellen Sie einen Einladungslink und geben ihn an Ihre Mitreisenden weiter. Wer ein Konto hat, lässt sich in jeder Reise über E-Mail-Adresse oder Benutzernamen hinzufügen. Wenn sich jede Person mit der Adresse selbst registrieren soll, schalten Sie unter Admin > Einstellungen die Passwort-Registrierung ein. Für Benachrichtigungen und vergessene Passwörter braucht TREK einen Mailserver. Die Zugangsdaten Ihres Mailservers tragen Sie unter Admin > Benachrichtigungen ein und prüfen sie mit einer Test-E-Mail.

Auf dem Smartphone installieren Sie TREK aus dem Browser als App, unter iOS über Teilen > Zum Home-Bildschirm, unter Android über Menü > App installieren. Dafür braucht der Seed ein gültiges Zertifikat, das er mit LETSENCRYPT=on von Let's Encrypt erhält. Weil alle Mitreisenden die Adresse von TREK auf ihren Geräten speichern, empfehlen wir von Anfang an eine eigene Domain. Sobald der A-Record Ihrer Domain auf die IPv4-Adresse des Seeds zeigt, stellen Sie TREK per SSH mit seed-tls domain trips.example.com um. Danach steht die Domain auch in Einladungslinks, und die bisherige Adresse leitet dorthin weiter. Erledigen Sie das, bevor jemand Passkeys anlegt, denn ein Passkey gilt nur für die Adresse, unter der er angelegt wurde.

In /opt/trek beschreibt die compose.yaml die Container trek und caddy. Die .env enthält die Images mit ihren Versionen, die Adresse von TREK, die Zeitzone und das erste Admin-Passwort, das TREK nur beim ersten Start liest. In /opt/trek/data liegen die Datenbank und der Schlüssel, mit dem TREK gespeicherte Zugangsdaten wie das SMTP-Passwort verschlüsselt. /opt/trek/uploads enthält die hochgeladenen Dateien und Fotos. Beide Verzeichnisse gehören in Ihre Sicherung. Unter Admin > Backup erstellen Sie ein ZIP mit Datenbank, Uploads und Schlüssel oder lassen es unter Auto-Backup täglich anlegen. Diese Backups liegen in /opt/trek/data/backups auf demselben Seed, und jedes enthält alle Uploads erneut. Laden Sie die Backups deshalb herunter oder wählen Sie unter Admin > Speicher ein externes Ziel. Weil das ZIP den Schlüssel enthält, bewahren Sie es so sicher auf wie Ihre Zugangsdaten.

Vor einem Update lesen Sie die Release Notes von TREK und legen einen Snapshot des Seeds an. Dann ersetzen Sie in der .env den ganzen Wert von TREK_IMAGE einschließlich des @sha256-Teils durch die neue Version, etwa docker.io/mauriceboe/trek:5.1.1, und führen in /opt/trek nacheinander docker compose pull und docker compose up -d aus. Für Caddy gilt dasselbe mit CADDY_IMAGE. Docker selbst aktualisieren Sie mit apt update && apt upgrade. Nach einem Neustart des Seeds starten beide Container automatisch.

Für die Orts- und Adresssuche, die Routenberechnung und die Details zu Orten nutzt TREK eigene Dienste des TREK-Projekts, die auf von dataforest gesponserten Servern laufen. Ihr Seed meldet sich dort bei der ersten Suche selbst an, einrichten müssen Sie nichts. Einmalig fragt TREK Sie als Admin, ob es die Ortsangaben Ihrer Mitglieder wie Öffnungszeiten oder Telefonnummern mit dem TREK-Projekt teilen darf. Ohne Ihre Zustimmung sendet TREK davon nichts, Ihre Wahl können Sie unter Admin > Einstellungen bei Ortsdetails teilen jederzeit ändern.