Selu aktualisieren

Selu enthält ein eingebautes Update-System, das deine Installation aktuell hält. Updates werden über die Seite Systemaktualisierungen verwaltet und laufen im Hintergrund mit Live-Fortschritt ab — kein Terminal nötig.

Was du brauchst

• Administratorzugang zu deiner Selu-Installation
• Docker Engine 29.2 oder neuer auf dem Host-Rechner

Achtung

Die aktuellen Selu-Images erfordern Docker Engine 29.2 oder neuer. Prüfe deine Version mit docker version. Liegt sie unter 29.2, aktualisiere Docker zuerst — die neuen Container starten sonst nicht.

Vor dem Aktualisieren

Sichere vor einem Update das vollständige verwaltete Daten-Volume. Stoppe Selu und den Updater kurz, damit Datenbank, Artefakt-Metadaten und zugehörige Laufzeitdateien konsistent bleiben:

SELU_DATA_VOLUME="$(grep '^SELU_DATA_VOLUME=' .env | cut -d= -f2-)"
test -n "${SELU_DATA_VOLUME}" || { echo "SELU_DATA_VOLUME fehlt in .env"; exit 1; }
docker compose stop selu selu-updater
docker run --rm \
  -v "${SELU_DATA_VOLUME}:/source:ro" \
  -v "${PWD}:/backup" \
  alpine:3.22 \
  tar czf "/backup/selu-data-$(date +%Y%m%d).tar.gz" -C /source .
docker compose start selu selu-updater

Bewahre .env und docker-compose.yml zusammen mit dem Archiv auf. Kopiere nicht nur selu.db aus einer laufenden Installation; eine Teilsicherung kann zugehörige Dateien auslassen oder einen inkonsistenten Stand erfassen.

Ein Update installieren

1. Melde dich als Administrator an und öffne Systemaktualisierungen in der Seitenleiste.
2. Klicke Jetzt prüfen, um nach einer neueren Version zu suchen.
3. Wenn ein Update verfügbar ist, klicke Aktualisierung installieren.
4. Bestätige im Dialog, der erscheint.
5. Der Fortschritt erscheint sofort auf der Seite und bleibt sichtbar, während Selu neu startet und sich wieder verbindet — du musst nichts weiter tun.

Wenn das Update fertig ist, verbindet sich die Seite automatisch wieder und zeigt die neue Version an.

Was du während des Updates siehst

Phase	Was passiert
Prüfen	Eine neuere Version wird gesucht
Vorbereiten	Download wird vorbereitet
Herunterladen	Das neue Docker-Image wird geladen
Neustarten	Die neue Version wird gestartet
Prüfen	Es wird kontrolliert, ob alles funktioniert
Fertig	Aktualisierung erfolgreich abgeschlossen

Wenn etwas schiefläuft, kehrt Selu automatisch zur vorherigen Version zurück.

Rollback

Falls ein Update Probleme verursacht, kannst du zur vorherigen Version zurückkehren:

1. Öffne Systemaktualisierungen.
2. Klicke Zur vorherigen Version.
3. Bestätige im Dialog.
4. Beobachte den Fortschritt — Selu startet mit der vorherigen Version neu und verbindet sich automatisch wieder.

Hinweis

Rollback ist nur möglich, wenn eine vorherige Version vorhanden ist. Nachdem du mindestens ein erfolgreiches Update durchgeführt hast, erscheint die Option auf der Seite.

Öffentliche Webadresse festlegen

Selu muss seine eigene öffentliche Adresse kennen, damit Webhooks, Mobile-Pairing und externe Integrationen funktionieren. Du legst diese auf der Seite Einstellungen fest — nicht in den Systemaktualisierungen.

1. Öffne Einstellungen in der Seitenleiste.
2. Suche die Karte Öffentliche Webadresse und klicke Adresse verwalten.
3. Gib deine vollständige Adresse ein (zum Beispiel https://selu.example.com) — ohne abschließenden Pfad.
4. Oder klicke Aktuelle Adresse verwenden, um sie automatisch aus dem Browser zu übernehmen.
5. Klicke Adresse speichern.

Die Adresse gilt sofort, ohne Neustart.

Automatische Updates

Du kannst Selu Updates selbstständig installieren lassen:

1. Öffne Systemaktualisierungen und klicke Aktualisierungseinstellungen.
2. Schalte Aktualisierungen automatisch installieren ein.
3. Wähle deinen bevorzugten Release-Kanal.
4. Klicke Einstellungen speichern.

Achtung

Automatische Updates starten Selu neu und unterbrechen kurzzeitig aktive Unterhaltungen. Überlege, wann du Selu typischerweise nutzt, bevor du das einschaltest.

Release-Kanäle

Kanal	Stabilität	Am besten für
Stabil	Hoch — gründlich getestet	Produktive Nutzung
Instabil	Gut — neue Funktionen früher	Neue Funktionen testen

Du kannst jederzeit in den Aktualisierungseinstellungen den Kanal wechseln. Die Änderung gilt ab der nächsten Prüfung.

Anonyme Installationsstatistik

Selu kann einmal täglich ein anonymes Signal an selu.bot senden, damit Nutzungszahlen und Marktplatz-Popularität angezeigt werden können.

Was gesendet wird

• Eine zufällige Installations-ID (einmalig erstellt, nie persönlich zuordenbar)
• Die installierte Selu-Version
• Installierte Marktplatz-Agenten-IDs und -Versionen

Selu sendet keine Unterhaltungen, Prompts, Nutzernamen, IP-Adressen oder Zugangsdaten.

Ausschalten

Öffne Systemaktualisierungen, klicke Aktualisierungseinstellungen und schalte Anonyme Installationsstatistiken aus. Selu sendet danach sofort nichts mehr.

Manuell aktualisieren

Wenn du lieber über die Kommandozeile aktualisierst:

Neueste Version

docker compose pull
docker compose up -d

Datenbank-Migrationen laufen automatisch. Einstellungen, Unterhaltungen und Zugangsdaten bleiben erhalten.

Bestimmte Version festlegen

Bearbeite deine docker-compose.yml und trage ein bestimmtes Tag ein:

docker-compose.yml

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

Dann anwenden:

docker compose up -d

Tipp

Die Web-Oberfläche ist der einfachere Weg — sie zeigt Live-Fortschritt, führt Gesundheitsprüfungen automatisch durch und bietet Rollback auf Knopfdruck. Nutze die Kommandozeile nur, wenn du einen bestimmten Grund dafür hast.

Problembehandlung

Update hängt oder zeigt einen Fehler

1. Prüfe die Fortschrittskarte auf konkrete Fehlermeldungen.
2. Stelle sicher, dass Docker läuft: docker ps
3. Prüfe deine Internetverbindung — das Update muss ein neues Image herunterladen.
4. Starte das Update erneut. Der Fortschritt wird fortgesetzt.
5. Bei anhaltenden Problemen prüfe die Updater-Logs: docker logs selu-updater

Docker-Version ist zu alt

Falls Selu nach einem Update nicht startet und die Logs die Docker-API erwähnen:

1. Prüfe mit docker version die Engine-Version.
2. Liegt sie unter 29.2, aktualisiere Docker Engine, bevor du es erneut versuchst.
3. Auf Linux folge der offiziellen Docker-Installationsanleitung für deine Distribution.
4. Auf macOS oder Windows aktualisiere Docker Desktop auf die neueste Version.

Automatische Updates funktionieren nicht

1. Stelle sicher, dass Aktualisierungen automatisch installieren in den Aktualisierungseinstellungen eingeschaltet ist.
2. Prüfe, ob der Release-Kanal korrekt gesetzt ist.
3. Stelle sicher, dass der Updater-Container läuft: docker ps | grep updater
4. Logs prüfen: docker logs selu-updater

Rollback-Option ist nicht sichtbar

Die Rollback-Option erscheint erst nach mindestens einem erfolgreichen Update. Wenn du schon aktualisiert hast und sie trotzdem nicht siehst, lade die Seite Systemaktualisierungen neu.

Angezeigte Version stimmt nicht

1. Lade die Seite neu (Strg+F5 unter Windows/Linux, Cmd+Shift+R auf dem Mac).
2. Prüfe die installierten Docker-Images: docker images | grep selu
3. Vergewissere dich auf der Seite Systemaktualisierungen, dass das Update erfolgreich abgeschlossen wurde.