For this tutorial, you will need:

Update passbolt

1. Take down your site

It is generally a good idea to stop running the site prior to the upgrade. This is to avoid having side effects such as active users corrupting the data in the middle of an upgrade.

$ sudo systemctl stop nginx

2. Backup your database

It is recommended to always perform a backup of your passbolt installation. Please check the backup article

3. Upgrade your system

Pro tip: Sometimes, while updating when there is also an update to MySQL/MariaDB you will get an error on the upgrade step. That’s why we are suggesting to manually upgrade passbolt prior to system upgrade

This commands will trigger an upgrade on your whole CentOS system:

$ sudo yum update

4. Clear the cache

Finally make sure you clear the application cache, to make sure any changes in the database structure are reflected in model cache files:

$ sudo -H -u nginx bash -c "/usr/share/php/passbolt/bin/cake cache clear_all"

5. Bring your site back online

Almost done:

sudo systemctl start nginx


Verifying the status of the application

Optionally, you can login as an administrator and check the status on the healthcheck page:

Example of healthcheck screen fig. Example of healthcheck screen

You can also run the following command:

$ sudo -H -u nginx bash -c "/usr/share/php/passbolt/bin/cake passbolt healthcheck"

If you run into some issues

If you run into some issues:

Where to get help:

The more information you provide about what you did, what you tried, how your environment look like, the easiest it will be for people to help you.

Last updated

This article was last updated on November 26th, 2021.

Your installation is not based on a debian package?

Migrate passbolt to debian package

Are you experiencing issues when updating passbolt?

Ask the community!