---
title: "Deploy Kaneo"
description: "Open-source project management: boards, tasks and team workspaces"
category: "Other"
url: https://railway.com/deploy/kaneo-2
---

# Deploy Kaneo

Open-source project management: boards, tasks and team workspaces

**[Deploy Kaneo on Railway](https://railway.com/template/kaneo-2)**

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

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

## Template content

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

### Kaneo https://raw.githubusercontent.com/usekaneo/kaneo/v2.49.0/apps/site/public/logo-512.png

- **Source:** https://github.com/aalfath/kaneo-railway-template
- **Health check:** /api/health
- **Public domain:** Yes

## Documentation

# Deploy and Host Kaneo on Railway

Kaneo is an open-source project management tool, MIT licensed. Teams organise work in workspaces and projects, and track tasks on boards and lists with labels, priorities, due dates, comments and subtasks. It can import from other tools and connect to GitHub, Gitea, GitLab, Slack, Discord and Telegram.

## About Hosting Kaneo

Kaneo ships as one official Docker image that holds the web app and its API behind a small nginx server on port 5173. All data lives in PostgreSQL, and Kaneo runs its database migrations on every start. This template builds Kaneo v2.49.0 from a GitHub repo that pins the official image by digest, and adds Railway's PostgreSQL with a persistent volume. The public URL, the database connection and the session secret are set for you, so the deploy asks no questions. Open the URL and sign up to create the first account. Email, single sign-on and file uploads are optional settings you can add later.

## Common Use Cases

* Kanban boards and task lists for a small team or a side project
* A self-hosted alternative to Jira, Linear or Trello that keeps project data on your own infrastructure
* Tracking issues that sync with GitHub, Gitea or GitLab repositories

## Dependencies for Kaneo Hosting

* PostgreSQL (Railway's PostgreSQL service, included in this template)
* A public HTTPS domain (a Railway domain is created automatically)

### Deployment Dependencies

* Kaneo source and releases: https://github.com/usekaneo/kaneo/releases/tag/v2.49.0
* Kaneo documentation: https://kaneo.app/docs
* Configuration reference (.env.sample): https://github.com/usekaneo/kaneo/blob/main/.env.sample
* Template repo: https://github.com/aalfath/kaneo-railway-template

### Implementation Details

* `KANEO_CLIENT_URL` is `https://${{RAILWAY_PUBLIC_DOMAIN}}`. If you add a custom domain, set it to that domain, for example `https://YOUR-DOMAIN`.
* Anyone who can reach the URL can sign up. After creating your account, set `DISABLE_REGISTRATION=true` on the Kaneo service and invite your team from the app.
* Optional: SMTP (`SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, `SMTP_PASSWORD`, `SMTP_FROM`) for invitations and sign-in codes, GitHub sign-in (`GITHUB_OAUTH_CLIENT_ID`, `GITHUB_OAUTH_CLIENT_SECRET`), and S3-compatible storage (`S3_ENDPOINT`, `S3_BUCKET`, `S3_ACCESS_KEY_ID`, `S3_SECRET_ACCESS_KEY`) for image uploads. Without S3, image uploads are turned off.
* Updates arrive as an "update available" notice when the template repo moves to a new Kaneo release. Back up Postgres before applying a major update.

## Why Deploy Kaneo 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 Kaneo 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

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/kaneo-2
