Docker passbolt installation
- docker: https://docs.docker.com/get-docker/
- docker-compose: https://docs.docker.com/compose/install/
- A Linux user able to run docker commands without sudo
- a working SMTP server for email notifications
- a working NTP service
- You have read this FAQ page about entropy
- Firewall rules implemented
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
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:
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.
- How to configure SMTP to receive emails
- How to configure HTTPS with my own certificates in docker
- How to configure HTTPS with Let’s Encrypt in docker
- How to use rootless images
- Troubleshoot Docker
- Passbolt reference environment variables
Passbolt docker repository:
This article was last updated on December 15th, 2021.