Installing Passbolt on Fedora CoreOS

In this tutorial, we will go through the steps to install Passbolt on a Fedora CoreOS server.

Prerequisites

  • A running instance of Fedora CoreOS.
  • A user account with sudo privileges.

Step 1: Install Docker

The first step is to install Docker on your Fedora CoreOS instance. Run the following command to install Docker:

sudo dnf install -y docker

Now, start the Docker service by running:

sudo systemctl start docker

To enable Docker to start automatically at boot time, run:

sudo systemctl enable docker

Step 2: Create a Passbolt data directory

Before we can start the Passbolt Docker container, we need to create a data directory that Passbolt will use to store its data. Run the following command to create the directory:

sudo mkdir /opt/passbolt-data

Step 3: Start the Passbolt Docker container

We will now start the Passbolt Docker container. Run the following command:

sudo docker run \
    --detach \
    --name passbolt \
    --restart always \
    --publish 80:80 \
    --volume /opt/passbolt-data:/var/www/passbolt/config \
    --env DATASOURCES_DEFAULT_HOST=mariadb \
    --env [email protected] \
    --env GPG_SERVER_KEY_PUBLIC="-----BEGIN PGP PUBLIC KEY BLOCK-----\n\nmQENBFds9cMBCAC933ixphDrOy/h1aUbWWsTz8FZZcU6vzVC1\nGgd9Xm8W3Bq1vBm\nuoHcyPbCS8DgGLaNOvnrHx/7MsZ+d+pXP1YcGCBvN5CEfSY5y5\ng+EpYOZ0zzp\nFGoTFgtMiB5r5r0y5lG44SOBbJv2xIp0zPN1X2UOeWUdMr6sjwathF\nOBl6qcz3\nh3vMZmxcJZUBwr9Z1m3qT21TnOiJtvG1s2y8bYCV31FvDr4N\nuvt7Nlf+NH\n/k1NFgQJsS/PUV7yJpYd+LgCSve4f4x7V9XPMtGG0OWV2Gfl\nuH7aJ32Y\nmAys7oohejxhSYJZ11spXMFq3DCaeTcc/oJLABEBAAG0G2RldmVsb3Bt\nYW4gIzQ2NjY2NjY2LTMwNjctNGI3Zi1hNjcwLTUxODkzZmEyYTM5NzB\niAQQA\nCQgAIBYhBL/kbNLYkCjx6Ur73waWUV/L8SPvRujJDobpBQJXbPXDAhsD\nBQsJCAcCBhUKCQgLAgQWAgMBAh4BAheAAAoJEB/L8SPvRujJDzsIAI4/4o\n7VNmCoPk8LYfx7EesN1gdxnNttnHEDrdMj7MtjjPFuiSy9XFZ+3qHXbgDMT\nLnBNn51w2QyjiEYJMjLSGmRFXZztx+bZ+KNMtozqT0ksdPgcpwrg2yfHPYJj\nvSBcR+u4fZ9V7/GLu8b2ZZV7yS46+ko0RTgDtn91p4CxrJN6nh1nCHJZzNn\nvByoyH5pa5Dk/vjyvsvo8AMQf5md86HeXEjX6UxxmW8ho/T6UdLogFkASlLb\nq3QN1vUn3+XZByqmP+oMOvJ/cn1Irzq1yfQ/ZEt+51lsWeoLloOGdcPPZcF7\nu4m1mBQj04tJ+RSg/M1S46wH\n=jcnJ\n-----END PGP PUBLIC KEY BLOCK-----" \
    passbolt/passbolt:latest

This command will start the Passbolt Docker container with the following options:

  • --detach: run the container in the background.
  • --name passbolt: name the container "passbolt".
  • --restart always: automatically restart the container if it stops for any reason.
  • --publish 80:80: map the container's internal port 80 to the host's port 80.
  • --volume /opt/passbolt-data:/var/www/passbolt/config: mount the Passbolt data directory to the container's /var/www/passbolt/config directory.
  • --env DATASOURCES_DEFAULT_HOST=mariadb: set the MariaDB database hostname for Passbolt to connect.
  • --env [email protected]: set the default email address for Passbolt.
  • --env GPG_SERVER_KEY_PUBLIC="...": set the PGP server key for Passbolt.

After running this command, you should be able to access Passbolt by navigating to your Fedora CoreOS instance's IP address in a web browser.

Step 4: Set up Passbolt

Now that you have Passbolt installed and running, you can proceed with setting it up by following the steps outlined in the official Passbolt documentation: https://help.passbolt.com/getting-started/setup/install.html#step-5-initialize-the-application

Conclusion

In this tutorial, we went through the steps to install Passbolt on Fedora CoreOS. With Passbolt installed, you can start managing your passwords and credentials with ease.