Updates einspielen

VirtueBot aktualisiert sich nicht von allein — du entscheidest, wann ein Update läuft. Diese Anleitung zeigt, wie du Updates einspielst, ein Backup vorher anlegst und im Notfall zur vorherigen Version zurückkehrst.

Wie ein Update läuft

Im Webpanel rechts oben siehst du, ob eine neue Version verfügbar ist. Klick auf das Symbol zeigt dir die Änderungen, die diese Version mitbringt — so weißt du vorher, was sich ändert.

Zum tatsächlichen Update gibt es zwei Wege:

Aus dem Panel heraus

Im Panel unter Globale Einstellungen → Updates findest du den Knopf „Jetzt aktualisieren". Er startet den Update-Vorgang automatisch — du musst dich nicht auf den Server einloggen.

Der Bot ist während des Updates kurz nicht erreichbar (ca. 30–60 Sekunden). Danach läuft er mit der neuen Version weiter, deine Daten bleiben unverändert.

Aus der Konsole

Wenn du auf dem Server eingeloggt bist:

virtuebot update

Selber Effekt wie der Panel-Knopf.

Vor dem Update — Backup anlegen

Wir empfehlen vor jedem Update ein Backup. Das geht über das Panel oder über die Konsole:

virtuebot backup

Die Backup-Datei landet in /opt/virtuebot/backups/ und enthält deine Daten und Konfiguration. Eine Backup-Datei ist meist nur wenige Megabyte groß.

Wenn du beim Setup automatische Backups aktiviert hast, läuft täglich eines davon automatisch. Du erkennst die Backup-Dateien am Datum im Dateinamen.

Auf die vorherige Version zurück (Rollback)

Falls nach einem Update etwas nicht mehr richtig läuft und du zur vorigen Version zurück willst, geht das in zwei Schritten:

Schritt 1 — Backup vor dem Update auswählen

Auf dem Server:

ls -la /opt/virtuebot/backups/

Du siehst eine Liste der Backup-Dateien mit Datum. Wähle die letzte vor dem Update — also die mit dem jüngsten Datum, das vor dem Update-Zeitpunkt liegt.

Schritt 2 — Backup einspielen

virtuebot restore /opt/virtuebot/backups/<dateiname>.tar.gz

Der Bot startet danach mit dem Stand des Backups neu.

Wichtig: Das Backup spielt deine Daten zurück — Songs, Playlists, Einstellungen, Berechtigungen. Die Software selbst bleibt auf der neueren Version. Wenn das Problem an einem konkreten neuen Software-Verhalten liegt (nicht an deinen Daten), reicht das Backup-Einspielen allein nicht.

In dem Fall: trage in der Konfigurations-Datei unter /opt/virtuebot/.env den Eintrag VIRTUEBOT_IMAGE mit der gewünschten Versionsnummer ein (z. B. VIRTUEBOT_IMAGE=ghcr.io/escanor24k/virtuebot:3.0.7) und starte den Bot mit virtuebot restart neu. Welche Versionen verfügbar sind, siehst du in den Patch-Notes im Panel.

Backups regelmäßig sichern

Die Backups landen auf dem gleichen Server wie der Bot. Wenn der Server ausfällt, sind sie auch weg.

Für mehr Sicherheit kopier die Backups regelmäßig auf einen anderen Speicher — z. B. mit scp auf einen anderen Server, in eine Cloud-Festplatte oder einfach auf deinen Laptop:

scp root@<dein-server>:/opt/virtuebot/backups/<dateiname>.tar.gz ./mein-backup-ordner/

Wenn du Backups automatisch verschieben willst, kannst du dafür den Cron-Job-Mechanismus deines Servers nutzen — wie das genau geht, ist je nach Setup unterschiedlich und liegt außerhalb dieser Anleitung.

Was passiert beim Update technisch?

VirtueBot prüft, ob eine neue Version verfügbar ist.
Es lädt die neue Version herunter.
Der laufende Bot wird gestoppt.
Die neue Version wird gestartet.
Datenbankschema wird, falls nötig, automatisch angepasst (ohne Datenverlust).

Deine Konfiguration und deine Daten bleiben unverändert.

Wenn ein Update nicht funktioniert

Update bleibt hängen oder Bot startet nicht neu: einmal virtuebot status ausführen, um zu sehen, ob etwas läuft. Dann virtuebot logs für eine Fehlermeldung.
„Patch konnte nicht eingespielt werden": meist eine kurzzeitige Netzwerk-Störung. Nach ein paar Minuten erneut versuchen.
Bot läuft, Panel zeigt aber Fehler: einmal Browser-Cache leeren (Strg+F5).

Weitere Hilfe: Troubleshooting.