Help Search

Update passbolt on Ubuntu 20.04

Prerequisites

For this tutorial, you will need:

  • A minimal Ubuntu 20.04 server.
  • Passbolt Ubuntu package installed.

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

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

$ sudo apt-get update
$ sudo apt-get upgrade

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 www-data bash -c "/usr/share/php/passbolt/bin/cake cache clear_all"

5. Take your site back up

Almost done:

sudo systemctl start nginx

Troubleshooting

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 www-data bash -c "./bin/cake passbolt healthcheck"

If you run into some issues

If you run into some issues:

  • Make a copy or screenshot of the errors messages displayed on the screen
  • Check for error message in the logs directory
  • Check for error message in the browser console
  • Checkout the previous working version using git
  • Drop the database and load your backup data to restore to a previously working version
  • Note down the the details of you environment: your OS, php, mysql environment versions.

Where to get help:

  • If you are a Passbolt Pro Edition subscriber send us an email with the details.
  • If you are a Passbolt Community Edition user you can open new thread on the community forum.

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 February 12th, 2021.

Your installation is not based on a Ubuntu package?

Migrate passbolt to Ubuntu package

Are you experiencing issues when updating passbolt?

Ask the community!

🍪   Do you accept cookies for statistical purposes? (Read more) Accept No thanks!