Help Search

Docker passbolt installation

System requirements

docker-compose

The easiest and recommended way to deploy your passbolt stack is to use docker-compose.

Step 1. Download our docker-compose.yml example file

curl -Ls https://raw.githubusercontent.com/passbolt/passbolt_docker/master/docker-compose/docker-compose-ce.yaml -o docker-compose.yaml

Step 2. Ensure the file has not been corrupted by verifying its sha256sum

$ sha256sum docker-compose.yaml

Must return:

e93807fdd2be20896e17a8b4bf95f51a427df98afa066aa5b802f68332c27484  docker-compose.yaml

Warning: If sha256sum is not correct, the downloaded file has been corrupted. Retry the download step or ask for support on our community forum.

Step 3. Configure environment variables in docker-compose.yaml file to customize your instance.

For more information on which environment variables are available on Passbolt, please check the passbolt environment variable reference.

Step 4. Start your containers

docker-compose up -d

Step 5. Create first admin user

$ docker-compose exec passbolt su -m -c "/usr/share/php/passbolt/bin/cake \
                                passbolt register_user \
                                -u <[email protected]> \
                                -f <yourname> \
                                -l <surname> \
                                -r admin" -s /bin/sh www-data

It will output a link similar to the below one that can be pasted on the browser to finalize user registration:

https://my.domain.tld/setup/install/1eafab88-a17d-4ad8-97af-77a97f5ff552/f097be64-3703-41e2-8ea2-d59cbe1c15bc

At this point, you should have a working docker setup running on the latest tag. However, it is recommended that users pull the tags pointing to specific passbolt versions when running in environments other than testing.

Going further

Docker FAQs:

Passbolt docker repository:

Last updated

This article was last updated on December 15th, 2021.

Available on docker hub

Docker Logo

Get passbolt container!

Are you experiencing issues when installing passbolt?

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