Webinstallation
Starte Sayrud als Binärdatei, mit Docker Compose oder Kubernetes und öffne http://server-address:2830/setup. Vor der Installation leitet auch die Startseite dorthin weiter.
Die Installation besteht aus vier Schritten: Identität bestätigen, Datenbank, Administrator und Abschluss. Die Sprache lässt sich oben rechts ändern.
Identität bestätigen
Ohne vorgegebenes Installationstoken erscheinen beim Start Setup token: und ein Installationslink mit Token in den Logs. Kopiere das Token auf die Seite und klicke auf „Bestätigen“. Ersetze bei entfernten Servern localhost im Link durch die tatsächliche Adresse.
| Bereitstellungsart | Logs anzeigen |
|---|---|
| Prozess im Vordergrund | Aktuelles Terminal |
| systemd | sudo journalctl -u sayrud -n 100 --no-pager |
| Docker Compose | docker compose logs --tail=100 sayrud |
| Kubernetes | kubectl -n sayrud logs deployment/sayrud --tail=100 |
Wenn SAYRUD_SETUP_TOKEN gesetzt ist, gib dessen Wert ein. Die K8s-Anleitung verwendet diese Methode; das Token steht in der lokalen Datei, aus der das Secret erstellt wurde.
Ein eigenes Token muss ohne Leerzeichen und Bindestriche mindestens 16 Zeichen lang sein. Du kannst es mit openssl rand -hex 24 erzeugen. Die Prüfung ignoriert Groß- und Kleinschreibung, Leerzeichen und Bindestriche.
Ohne festes Token erzeugt ein Prozessneustart während der Installation ein neues Token. Rufe es aus den neuesten Logs ab. Teile das Token und den Link damit nur mit der für die Installation zuständigen Person; nach dem Anlegen des Administrators werden die Installationsendpunkte geschlossen.
Datenbanken konfigurieren
Gib bei einer Neuinstallation folgende Daten ein:
| Dienst | Felder |
|---|---|
| PostgreSQL | Host, Port, Datenbankname, Benutzername, Passwort, SSL-Modus |
| Redis | Adresse im Format Host:Port sowie optional Benutzername und Passwort |
Die Verbindungen gehen vom Sayrud-Prozess aus, nicht vom Computer mit dem Browser. Die Docker-Compose-Konfiguration verwendet postgres und redis:6379; K8s verwendet interne Service-Namen oder erreichbare externe Domains.
PostgreSQL bietet die SSL-Modi „Unverschlüsselt“, „Verschlüsselt“, „Verschlüsselt, CA prüfen“ und „Verschlüsselt, CA und Hostname prüfen“. Wähle den vom Datenbankdienst verlangten Modus. Bei Zertifikatsprüfung muss auch die Laufzeitumgebung der jeweiligen CA vertrauen.
Klicke auf „Verbindung testen“, prüfe die erfolgreiche Verbindung zu PostgreSQL und Redis und klicke anschließend auf „Speichern und weiter“.
Administrator anlegen
Gib E-Mail-Adresse, Benutzername, Passwort und Passwortbestätigung ein und klicke auf „Installation abschließen“.
Damit wird der erste Systemadministrator angelegt und automatisch angemeldet. Über „Loslegen“ gelangst du zur Anwendung.
Prüfe nach der Installation, ob du Projekte erstellen, Datensätze bearbeiten und Anhänge hochladen kannst und ob Konfiguration und Uploads dauerhaft gespeichert werden. Website-Einstellungen, Benutzerregistrierung, Anmeldeverfahren und KI-Modelle lassen sich in der Administration anpassen.
Konfiguration vorab bereitstellen
Wenn ein Konfigurationsmanagement die Verbindungsdaten bereitstellt, kannst du sayrud.yaml vorab anlegen. Die folgende Konfiguration verwendet lokalen Speicher; ersetze zuerst das Verbindungspasswort und auth.secret_key:
postgres:
dsn: "postgres://sayrud:[email protected]:5432/sayrud?sslmode=disable"
redis:
address: "127.0.0.1:6379"
username: ""
password: ""
auth:
secret_key: "REPLACE_WITH_BASE64_KEY"
storage:
type: local
local:
path: ./data/storageErzeuge auth.secret_key mit diesem Befehl und übernimm die vollständige Ausgabe in die Konfiguration:
openssl rand -base64 32Wenn du eine PostgreSQL-URL von Hand schreibst, müssen Sonderzeichen im Passwort wie @, : und / URL-kodiert werden. Bei der Eingabe im Assistenten übernimmt das Programm die Kodierung.
Lege die Datei am in den Startargumenten angegebenen Pfad ab. Weitere Optionen findest du in der Beispielkonfiguration. Starte das Programm nach Konfigurationsänderungen neu.
Fehlerbehebung
Die Installationsseite erscheint nicht
Wenn die Logs einen erfolgreichen Start anzeigen und bereits Benutzer in der Datenbank vorhanden sind, wird die Anwendung direkt angezeigt. Melde dich mit einem vorhandenen Konto an.
Das Installationstoken ist ungültig
Prüfe, ob der Prozess während der Installation neu gestartet wurde. Ohne SAYRUD_SETUP_TOKEN verwende das Token aus den neuesten Logs. Prüfe unter K8s, ob der Pod das erwartete Secret verwendet, und verwende bei der Erstinstallation nur eine Replik. Wiederholte Fehleingaben lösen eine Begrenzung der Versuche aus; prüfe das Token vor dem nächsten Versuch.
Der Datenbank-Verbindungstest schlägt fehl
Prüfe, ob die Datenbank angelegt wurde, die Zugangsdaten stimmen und der Anwendungshost oder Pod die Zieladresse erreichen kann. Im Container verweist 127.0.0.1 auf den Container selbst. Wenn die Verbindung funktioniert, das Speichern aber fehlschlägt, prüfe auch die Rechte zur Schemamigration.
Der Assistent für eine Neuinstallation übernimmt keine Datenbank mit vorhandenen Benutzern. Stelle bei einer bestehenden Instanz die ursprüngliche Konfiguration, den Schlüssel und die Uploads wieder her und verbinde sie beim normalen Start mit der ursprünglichen Datenbank. Wiederhole nicht den Schritt zur Datenbankeinrichtung.
Berechtigungsfehler beim Speichern der Konfiguration
Der Assistent schreibt zunächst eine temporäre Datei im Konfigurationsverzeichnis und übernimmt sie anschließend als sayrud.yaml. Das Verzeichnis muss daher beschreibbar sein. Prüfe schreibgeschützte Einbindungen, ConfigMaps, Secrets und Abweichungen zwischen der UID/GID des Prozesses und dem Volume-Eigentümer. Die Docker- und K8s-Images verwenden 10001:10001.
Die Konfiguration wurde gespeichert, ein Neustart ist aber erforderlich
Prüfe die Logs, behebe den nachfolgenden Initialisierungsfehler und starte mit demselben Konfigurationspfad neu. Die gespeicherte Datei wird erneut eingelesen; Löschen und Neuinstallation sind nicht erforderlich.
Nach dem Neuerstellen des Containers erscheint wieder die Installationsseite
Prüfe, ob das Konfigurationsverzeichnis unter /home/app/config eingebunden ist, weiterhin die ursprüngliche PostgreSQL-Datenbank verwendet wird und sich Compose-Projektname oder K8s-PVC geändert haben. Stelle die ursprüngliche Konfiguration und Daten wieder her, bevor du eine neue Installation beginnst.