---
title: "Deploy Passbolt"
description: "Passbolt CE 5.18 team password manager: pinned, MariaDB, keys on a volume"
category: "Authentication"
url: https://railway.com/deploy/passbolt-1
---

# Deploy Passbolt

Passbolt CE 5.18 team password manager: pinned, MariaDB, keys on a volume

**[Deploy Passbolt on Railway](https://railway.com/template/passbolt-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/passbolt-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Authentication

## Template content

### MariaDB

- **Image:** mariadb:10.11.19@sha256:7d829180b5b2a9ba74f6242876ab401a0d7dd338a807e522ef92bc9698760f20

### Passbolt https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/passbolt.png

- **Source:** https://github.com/aalfath/passbolt-railway-template
- **Health check:** /healthcheck/status
- **Public domain:** Yes

## Documentation

# Deploy and Host Passbolt on Railway

Passbolt is an open source password manager for teams. Every password is encrypted in the browser with OpenPGP and shared by encrypting it to each colleague's key, so the server never sees plain-text secrets. Teams use it to share server logins, API keys and service accounts with per-folder and per-group permissions.

## About Hosting Passbolt

This template deploys Passbolt Community Edition 5.18.0 and a MariaDB 10.11 database. Both images are pinned by version and digest. Passbolt builds from a public GitHub repo, so you get Railway's "update available" notice when the template moves to a new release. The server's OpenPGP key and JWT keys live on a volume, and MariaDB has its own volume, so a redeploy keeps everything. Database passwords are generated per deployment. The only prompt is the first administrator's email. After the deploy, open the Passbolt service's deploy logs and find the one-time `/setup/start/...` link, then open it in a browser that has the Passbolt extension installed.

## Common Use Cases

* Share infrastructure, database and SaaS credentials inside an engineering or IT team
* Replace passwords kept in spreadsheets, chat messages or a shared vault file
* Give agencies and contractors scoped, revocable access to client credentials

## Dependencies for Passbolt Hosting

* MariaDB 10.11 (included in this template, with a volume)
* The Passbolt browser extension (Chrome, Firefox, Edge or Safari) for every user

### Deployment Dependencies

* Passbolt CE release notes: https://github.com/passbolt/passbolt_api/releases
* Passbolt Docker installation guide: https://www.passbolt.com/docs/hosting/install/ce/docker/
* Environment variable reference: https://www.passbolt.com/docs/hosting/configure/environment-reference/
* Template source: https://github.com/aalfath/passbolt-railway-template

### Implementation Details

**First login.** Install the Passbolt extension. In Railway, open Passbolt, go to Deployments, open View logs, and copy the line `[railway] ... Setup link: https://YOUR-DOMAIN/setup/start/...`. Open it, choose a passphrase and download the recovery kit. The kit is the only copy of your private key. The link stays valid for 10 days and is printed again on every restart until setup is finished.

**Back up the server key.** The volume at `/data/gpg` holds the server's OpenPGP key. Without it, the data in the database can't be used. Keep a copy of `/data/gpg` and regular MariaDB dumps.

**Email (optional).** Invitations and account recovery are sent by email. Add `EMAIL_TRANSPORT_DEFAULT_HOST`, `EMAIL_TRANSPORT_DEFAULT_PORT`, `EMAIL_TRANSPORT_DEFAULT_USERNAME`, `EMAIL_TRANSPORT_DEFAULT_PASSWORD` and `EMAIL_DEFAULT_FROM` to the Passbolt service, or configure SMTP in Passbolt's administration pages.

**Custom domain.** After you add one, set `APP_FULL_BASE_URL` to `https://YOUR-DOMAIN`.

**Updates.** When the template's repo moves to a new Passbolt release, Railway shows an update notice in your project. Read the repo's CHANGELOG first. Passbolt runs its database migrations on start.

## Why Deploy Passbolt on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Passbolt on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## Similar templates

- [Keycloak](https://railway.com/deploy/mSwigX) — [2026-11-04] Keycloak with keywind theme + Apple & Discord providers
- [lua-protector](https://railway.com/deploy/lua-protector) — Test deployed my project first
- [bknd](https://railway.com/deploy/p4nTYL) — Feature-rich yet lightweight backend

Open this page in a browser: https://railway.com/deploy/passbolt-1
