Anleitungen /

Aktualisierungsanleitung

/

Docker-Image-Aktualisierung

Docker-Image-Aktualisierung

Diese Anleitung gilt nur für das offizielle Piwigo-Image. Wenn Sie einen LinuxServer-Container verwenden, lesen Sie bitte stattdessen die entsprechende Dokumentation.

Wenn Sie zum offiziellen Image wechseln möchten, können Sie dieser Anleitung folgen.

Schritt 1 – Nach Updates suchen

Die Versionsnummer der Container entspricht immer der Piwigo-Version. Ab Version 16.3.0 wird ihnen ein zusätzlicher Buchstabe hinzugefügt, um containerspezifische Updates zu ermöglichen.

Für Container der Version 16.3 und höher

Sie sollten bereits in der Update-Oberfläche sehen können, ob Updates verfügbar sind. Wenn Sie auf die Minor-Version aktualisieren möchten, verwenden Sie die erste Zahl mit dem Tag (z. B.: 16).

Für Container der Version 16.2 und niedriger

Gehen Sie zu der Tagliste und suchen Sie das Tag, das Sie aktualisieren möchten.

Schritt 2 – Erstellen Sie eine Sicherungskopie

Um sicherzustellen, dass die Aktualisierung risikofrei ist, sollten Sie sowohl von der Datenbank als auch von den Dateien Ihrer Piwigo-Instanz ein Backup erstellen.

Datenbanksicherung

Sie können mit dem folgenden Befehl eine Sicherungskopie Ihrer Datenbank erstellen:

docker exec -it piwigo-db-1 mariadb-dump -u piwigodb_user -p "piwigodb" | tee db_dump.sql

Das Datenbankpasswort sollte mit dem übereinstimmen, das Sie in .env eingegeben haben (achten Sie darauf, den Containernamen so zu ersetzen, dass er mit Ihrem übereinstimmt).

Sie können Ihren Container nun durch Ausführen von docker compose down stoppen.

Dateien sichern

Um alle auf Ihr Piwigo hochgeladenen Bilder/Fotos zu sichern, kopieren Sie die folgenden Ordner:


      ./piwigo-data/piwigo/
      ├── galleries
      ├── local
      └── upload
    

Sichern Sie Compose- und env-Dateien

Benennen Sie Ihre Compose- und Env-Dateien um, indem Sie am Ende .bak hinzufügen (z. B.: .env.bak).

Schritt 3 – Die neue Compose-Datei abrufen und .env aktualisieren

Sie können die neueste Version der Datei compose.yaml mit dem folgenden Befehl abrufen:

curl -O "https://raw.githubusercontent.com/Piwigo/piwigo-docker/refs/heads/main/compose.yaml"

Überprüfen Sie das GitHub-Wiki, um die zu Ihrer Version passende .env-Datei zu erhalten.

Schritt 4 – Aktualisieren und Neustarten des Containers

Ziehen Sie das Image mit docker compose pull und starten Sie es mit docker compose up neu.

Sobald Sie sich vergewissert haben, dass alles funktioniert, können Sie das Terminal durch Drücken von d trennen.

Sind noch Fragen offen?

Sie können Hilfe und Antworten im Forum erhalten.