Selu aktualisieren

Selu enthält ein eingebautes System-Updates-Interface, das Aktualisierungen sicher und einfach macht. Updates bringen neue Funktionen, Fehlerbehebungen und Sicherheits-Patches.

Das System-Updates-Interface verwenden

Der einfachste Weg, Selu zu aktualisieren, ist über die Web-Oberfläche:

1. Zu System-Updates gehen — Im Selu-Dashboard klicke auf “System-Updates” in der Seitenleiste (nur Admin).

2. Release-Kanal wählen:

   • Stable (empfohlen) — Getestete Releases mit vollständigem Changelog
   • Dev — Neuere Funktionen, häufiger aktualisiert
   • Nightly — Tägliche Builds, möglicherweise instabil

3. Nach Updates suchen — Klicke “Jetzt prüfen” oder warte auf die tägliche automatische Prüfung.

4. Changelog überprüfen — Vor dem Update klicke “Changelog öffnen” um zu sehen, was sich geändert hat.

5. Aktualisieren — Klicke “Jetzt aktualisieren”. Selu wird:

   • Die neue Version im Hintergrund herunterladen
   • Mit dem neuen Image neu starten
   • Gesundheitsprüfungen ausführen um sicherzustellen, dass alles funktioniert
   • Automatisch zurückrollen wenn Gesundheitsprüfungen fehlschlagen

Die Oberfläche zeigt Versionsinformationen klar an:

• Versionsnummer (z.B. v1.5.0-dev)
• Build-Nummer zur Verfolgung spezifischer Builds
• Changelog-Link zum Überprüfen von Änderungen vor dem Update

Tipp

Aktiviere automatische Updates auf der System-Updates-Seite um neue Versionen von deinem gewählten Kanal automatisch anzuwenden, wenn sie erkannt werden.

Anonyme Installationsstatistik

Selu kann einmal täglich ein anonymes Signal an selu.bot senden, damit auf der Website Installations- und Marktplatz-Statistiken angezeigt werden können.

Welche Daten werden genau gesendet

• Installations-ID: eine zufällige, feste ID, die einmal pro Selu-Installation erzeugt wird
• Selu-Version: die aktuell installierte Version
• Installierte Marktplatz-Agenten-IDs: für aktive Nutzung pro Marktplatz-Agent
• Installierte Marktplatz-Agenten-Versionen: für die Verteilung pro Agent-Version

Es werden keine weiteren Daten in dieser Telemetrie übertragen.

Selu sendet keine Chats, Prompts, Nutzernamen, IP-Adressen oder Zugangsdaten in diesem Signal.

Warum diese Daten erhoben werden

• Anzahl aktiver Selu-Installationen anzeigen
• Anteil der Installationen auf der neuesten Version anzeigen
• Aktive Nutzer pro Marktplatz-Agent anzeigen

So kannst du widersprechen (Opt-out)

Öffne in der Selu-Oberfläche System Updates und schalte Anonyme Installationsstatistik aus. Wenn das ausgeschaltet ist, sendet Selu keine Telemetrie-Signale mehr.

Manuelles Aktualisieren (erweitert)

Wenn du manuelle Kontrolle bevorzugst oder Probleme beheben musst:

Standard-Update

Die neuesten Images laden und Container neu erstellen:

docker compose pull
docker compose up -d

Selu handhabt Datenbank-Migrationen automatisch. Deine Einstellungen, Zugangsdaten und Unterhaltungen bleiben erhalten.

Auf bestimmte Version festlegen

Bearbeite deine docker-compose.yml um ein spezifisches Image-Tag zu verwenden:

services:
  selu:
    image: ghcr.io/selu-bot/selu:v1.5.0

Dann aktualisieren:

docker compose up -d

Release-Kanäle

Selu bietet drei Release-Kanäle für verschiedene Bedürfnisse:

Kanal	Update-Häufigkeit	Stabilität	Am besten für
Stable	Haupt-Releases	Hoch	Produktive Nutzung
Dev	Wöchentlich	Gut	Frühzugriff auf Funktionen
Nightly	Täglich	Variabel	Testen und Entwicklung

Du kannst jederzeit in System-Updates die Kanäle wechseln. Das System erkennt und bietet Updates an, die für deinen neuen Kanal geeignet sind.

Vor dem Aktualisieren

:::caution Wichtige Schritte

1. Changelog lesen — Prüfe was sich ändert, besonders bei Breaking Changes
2. Datenbank sichern — Wesentlich für die Wiederherstellung wenn etwas schief geht
3. Aktuelle Version notieren — In System-Updates für Rollback-Referenz angezeigt :::

Für manuelle Sicherung kopiere die SQLite-Datenbankdatei:

# Ein Backup mit heutigem Datum erstellen
cp ./data/selu.db backup-selu-$(date +%Y%m%d).db

Rollback-Schutz

Selus Update-System enthält automatischen Rollback:

• Gesundheitsprüfungen — Nach dem Update testet Selu, ob Kernfunktionen funktionieren
• Automatischer Rollback — Wenn Gesundheitsprüfungen fehlschlagen, wird die vorherige Version wiederhergestellt
• Manueller Rollback — Verwende den “Rollback”-Button in System-Updates um zur vorherigen Version zurückzukehren

Für manuellen Rollback:

1. Via System-Updates — Klicke “Rollback” wenn verfügbar
2. Via Docker — Stelle das vorherige Image-Tag in docker-compose.yml wieder her und führe docker compose up -d aus
3. Datenbank-Wiederherstellung (falls nötig) — Stoppe Selu, dann cp backup-selu-20260301.db ./data/selu.db und neu starten

Administrative Passwort-Wiederherstellung

Wenn du das Passwort eines Benutzers vergisst und es zurücksetzen musst, bietet Selu einen sicheren CLI-Befehl für Administratoren:

# Benutzer-Passwort zurücksetzen (liest neues Passwort von stdin)
echo 'neues-sicheres-passwort' | docker exec -i selu-orchestrator selu-orchestrator reset-password --username alice --password-stdin

Dieser Befehl:

• Erfordert, dass das neue Passwort mindestens 8 Zeichen lang ist
• Hasht das Passwort sicher mit Argon2id
• Widerruft alle aktiven Web-Sitzungen für diesen Benutzer
• Funktioniert auch wenn die Web-Oberfläche nicht erreichbar ist

:::danger Sicherheitshinweis Dieser Befehl erfordert direkten Zugriff auf den Selu-Container und sollte nur von Systemadministratoren verwendet werden. Das Passwort wird über stdin übergeben damit es nicht in der Befehlshistorie erscheint. :::

Umgebungsvariablen

Das Update-System verwendet diese Umgebungsvariablen in deiner .env-Datei:

Variable	Beschreibung	Standard
SELU_RELEASE_CHANNEL	Release-Kanal (stable, dev, nightly)	stable
SELU_IMAGE_TAG	Aktueller Image-Tag	Vom Update-System gesetzt
SELU_IMAGE_DIGEST	Aktueller Image-Digest zur Validierung	Vom Update-System gesetzt
SELU_IMAGE_VERSION	Aktuelle Release-Version (z.B. v1.5.0)	Vom Update-System gesetzt
SELU_IMAGE_BUILD	Aktuelle Build-Nummer	Vom Update-System gesetzt

Hinweis

Diese Variablen werden automatisch vom Update-System verwaltet. Du musst sie normalerweise nicht manuell setzen.

Agenten aktualisieren

Agenten werden separat vom Selu-Server aktualisiert. Wenn Agent-Updates verfügbar sind:

1. Gehe zu Agenten im Dashboard
2. Suche nach Agenten mit einem “Update verfügbar”-Badge
3. Klicke Aktualisieren und überprüfe das Changelog des Agenten
4. Bestätige das Update

Agent-Konfigurationen und -Daten bleiben über Updates hinweg erhalten.

Problembehandlung

Wenn Updates nicht funktionieren:

1. Docker prüfen — Stelle sicher, dass Docker läuft und erreichbar ist
2. Konnektivität prüfen — Selu braucht Internetzugang um Updates herunterzuladen
3. Logs prüfen — Suche nach Fehlermeldungen im System-Updates-Interface
4. Manuelles Update — Falle zurück auf docker compose pull && docker compose up -d

Häufige Probleme:

• “Updates konnten nicht geprüft werden” — Netzwerk-Konnektivitäts- oder Docker-Probleme
• “Update fehlgeschlagen” — Normalerweise Docker-Pull-Probleme oder unzureichender Festplattenspeicher
• Gesundheitsprüfungs-Fehler — Datenbank-Migrations-Probleme oder Konfigurationsprobleme

Auf dem Laufenden bleiben

• Eingebaute Benachrichtigungen — System-Updates zeigt an, wann neue Versionen verfügbar sind
• Changelog — Immer vom Update-Interface verlinkt
• Community — Nimm teil an Diskussionen über Updates in der Selu-Community

Das System-Updates-Interface prüft täglich nach neuen Releases und benachrichtigt dich, wenn Updates für deinen gewählten Kanal verfügbar sind.