Help Search

Migrate from install scripts to debian package

1. Backup your instance

First things first, as this is a sensitive operation a backup of the the instance must be performed to prevent any data-loss. You can follow our backup process

2. Install passbolt debian package

You can follow the instructions to install passbolt debian package here for the community edition and here for the pro edition.

It is recommended at this point to select:

  • No for mysql configuration as it is already configured
  • No to nginx configuration as we will do it at the end

3. Copy GPG keys to the new location

sudo cp /var/www/passbolt/config/gpg/* /etc/passbolt/gpg/
sudo chown root:www-data /etc/passbolt/gpg/*
sudo chmod g-w /etc/passbolt/gpg

4. Copy passbolt.php configuration

sudo cp /var/www/passbolt/config/passbolt.php /etc/passbolt/passbolt.php
sudo chown root:www-data /etc/passbolt/passbolt.php
sudo chmod g-w /etc/passbolt/passbolt.php


Edit /etc/php/7.3/fpm/pool.d/www.conf and look for the line that looks like this:

listen =

Change it to look like this:

listen = /run/php/php7.3-fpm.sock

Due to a bug on the install scripts some installations might need to do an additional substitution on /etc/php/7.3/fpm/pool.d/www.conf:

Look for the line containing: = _WWW_GROUP_

And change it to look like: = www-data

6. Nginx

Now you can remove all the old nginx configuration files from /etc/nginx/conf.d/

sudo rm /etc/nginx/conf.d/passbolt.conf
sudo rm /etc/nginx/conf.d/passbolt_ssl.conf

Then you can reconfigure the debian package using:

sudo dpkg-reconfigure passbolt-ce-server

Or, if you are using the pro:

sudo dpkg-reconfigure passbolt-pro-server

Answer the following way:

  • No to mysql configuration
  • Yes to nginx configuration

You can then select the SSL method that suits best your needs.

7. Cleanup

After you have checked you can access your new setup with the debian package make a backup of /var/www/passbolt and then you can delete it:

rm -rf /var/www/passbolt

Are you experiencing issues when updating passbolt?

Ask the community!

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