Zum Inhalt

Docker-Update

Diese Anleitung betrifft nur Benutzer des offiziellen Docker-Images.

Diese Anleitung gilt nur für das offizielle Piwigo-Image. Wenn Sie einen Container von LinuxServer verwenden, nutzen Sie bitte stattdessen deren Dokumentation.
Wenn Sie zum offiziellen Image wechseln möchten, können Sie dieser Anleitung folgen.

Schritt 1 - Nach Updates suchen

Die Versionsnummern des Containers entsprechen immer der Piwigo-Version. Ab 16.3.0 folgt ihnen zusätzlich ein Buchstabe, damit auch containerspezifische Updates möglich sind.

Sie sollten bereits in der Update-Oberfläche sehen können, ob ein Update verfügbar ist:

Beispiel einer Update-Liste

Öffnen Sie die Tag-Liste auf dockerhub oder auf GitHub und suchen Sie den gewünschten Tag.

Schritt 2 - Ein Backup erstellen

Damit das Update ohne Risiko abläuft, sollten Sie sowohl von der Datenbank als auch von den Dateien Ihrer Piwigo-Instanz ein Backup erstellen. Wechseln Sie in den Ordner, in dem sich Ihre compose.yaml befindet.

Backup Ihrer Datenbank

Mit dem folgenden Befehl können Sie ein Backup Ihrer Datenbank erstellen (ersetzen Sie piwigo-db-1 durch den Namen Ihres Datenbank-Containers):

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

Backup Ihrer Galerie und Konfigurationsdateien

Um alle in Ihr Piwigo hochgeladenen Bilder/Fotos und Ihre aktuelle Konfiguration zu sichern, kopieren Sie die folgenden Ordner aus dem Ordner ./piwigo-data/piwigo/: galleries, upload und local.

Je nach Anzahl Ihrer Fotos können galleries und upload sehr viel Speicherplatz belegen

Backup Ihrer Dateien compose.yaml und .env

Benennen Sie Ihre compose.yaml um und erstellen Sie eine Kopie Ihrer .env (zum Beispiel, indem Sie .bak am Ende anhängen).

Mit den folgenden Befehlen können Sie ein Backup mit Zeitstempel erstellen 
mv compose.yaml "compose.yaml_$(date '+%F-%H-%M-%S').bak" 
cp .env "env$(date '+%F-%H-%M-%S').bak"

Schritt 3 - Die neue Compose-Datei herunterladen und .env aktualisieren

  • Laden Sie die Version der compose.yaml herunter, die dem in Schritt 1 gewählten Tag entspricht.

Mit dem folgenden Befehl können Sie sie abrufen. Ersetzen Sie einfach <TAG> durch den gewählten Tag (z. B. 16.4a).

PWG_DOCKER_VERSION="<TAG>"; curl -O "https://raw.githubusercontent.com/Piwigo/piwigo-docker/refs/tags/v$PWG_DOCKER_VERSION/compose.yaml"
  • Lesen Sie die Seite im Github Wiki und passen Sie Ihre .env-Datei entsprechend an.
Beispiel für ein Update von Version 15.6 auf Version 16.3c

.env vor dem Update:

piwigo_port=8080
db_user_password=4JKQplDWaePjjwqiuAmcWWrwY3oqxWtxRs2XCEObf1wRdD2boDa6VA804kzQm2kj

Wir fügen das Feld timezone hinzu, da es mit 15.7.0 eingeführt wurde, sowie die Felder UID/GID, die mit 16.3.0c eingeführt wurden.

piwigo_port=8080
db_user_password=4JKQplDWaePjjwqiuAmcWWrwY3oqxWtxRs2XCEObf1wRdD2boDa6VA804kzQm2kj
timezone=Europe/Paris
PIWIGO_UID=1004
PIWIGO_GID=1001

Schritt 4 - Den Container aktualisieren und neu starten

Laden Sie das Image mit docker compose pull herunter und starten Sie Ihre Container mit docker compose up -d neu.
Mit docker compose logs können Sie in den Logs prüfen, ob alles einwandfrei funktioniert.