Step 1 - Checking for updates

Containers' version numbers will always match the Piwigo version, starting from 16.3.0 they will have an extra letter after to allow container specific updates

For container version 16.3 and higher

You should already be able to see if any update is available in the update interface, if you want to update to the minor version use the first number the tag has (eg: 16)

For container version 16.2 and lower

Go to the taglist and search the tag you want to update to

Step 2 - Create a backup

To make sure updating is risk free, you should make a backup of both the database and the files of your Piwigo instance

Database backup

You can create a backup of your database using the following command:

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

The database password should be the same as the one you put in .env (be sure to subsitue the container name so it matches yours)

You can now stop your container by running docker compose down

Files backup

To backup any image/photo uploaded to your Piwigo, copy the following folders:

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

Backup compose and env files

Rename your compose and env files by adding a .bak at the end (eg: .env.bak)