Deploy Kanboard

kanboard template with PostgreSQL

Deploy Kanboard

/var/lib/postgresql/data

Just deployed

/var/www/app/data

Kanboard on Railway

For a self-hosted Kanban task board on Railway with persistent plugins, use Kanboard with PostgreSQL. The official Kanboard image connects to the database and enables the web plugin installer, with installed plugins retained across ordinary restarts and redeployments. Open the deployed URL, change the initial administrator password promptly, and configure SMTP separately if you need email notifications.

Required environment variables

Provide only the following variables in your Railway service:

# Enable plugin installation from the Kanboard UI
PLUGIN_INSTALLER="true"

# Public base URL of your Kanboard instance (Railway injects the domain)
KANBOARD_URL="https://${{RAILWAY_PUBLIC_DOMAIN}}"

# PostgreSQL connection URL (from the Railway Postgres plugin)
DATABASE_URL="postgres://${{Postgres.PGUSER}}:${{Postgres.PGPASSWORD}}@${{Postgres.PGHOST}}:${{Postgres.PGPORT}}/${{Postgres.PGDATABASE}}"

Note: Railway sets PORT automatically; no change is required in Kanboard for listening ports.

What this template includes

  • Official image kanboard/kanboard (no custom forks).
  • PostgreSQL as the application database via Railway’s managed plugin.
  • Plugin installer enabled (from the Kanboard UI).
  • Persistent plugins: plugins installed from the UI are saved to the app’s data storage so they survive service restarts and redeployments. No extra action is needed on your side.

Quick start

  1. Create a new Railway project from this template.
  2. Deploy and open your public URL (the admin default is admin / admin).

Operational notes

  • You can keep PLUGIN_INSTALLER="true" while you add or update plugins, then switch it to "false" later for stricter security if desired.
  • If you configure email notifications later, add the standard MAIL_* variables in Railway (SMTP host, port, user, password, encryption, and from address).
  • Backups: snapshot the PostgreSQL database from Railway and, if needed, export board/task data from Kanboard’s UI.

🧑‍💼 Default Account

After deployment, log in with:

Username: admin
Password: admin

You can change this password anytime at:

https://${{RAILWAY_PUBLIC_DOMAIN}}/user/1/password

For further configuration options, consult the official documentation at docs.kanboard.org.

Other deployment choices from this publisher


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0