
Deploy Kaneo
Open-source project management: boards, tasks and team workspaces
Just deployed
/var/lib/postgresql/data
Just deployed
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_URLishttps://${{RAILWAY_PUBLIC_DOMAIN}}. If you add a custom domain, set it to that domain, for examplehttps://YOUR-DOMAIN.- Anyone who can reach the URL can sign up. After creating your account, set
DISABLE_REGISTRATION=trueon 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.
Template Content
