---
title: "Deploy Kaneo 2 Project Management (Postgres, S3 uploads)"
description: "Kanban, list and timeline project tracking with a pre-created admin."
category: "Other"
url: https://railway.com/deploy/kaneo-2-project-management-postgres-s3-u
---

# Deploy Kaneo 2 Project Management (Postgres, S3 uploads)

Kanban, list and timeline project tracking with a pre-created admin.

**[Deploy Kaneo 2 Project Management (Postgres, S3 uploads) on Railway](https://railway.com/template/kaneo-2-project-management-postgres-s3-u)**

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

- **Creator:** Tracklayer
- **Category:** Other
- **Total deploys:** 1

## Template content

### Kaneo https://cdn.jsdelivr.net/gh/selfhst/icons/svg/kaneo.svg

- **Source:** baranberkay96/kaneo-railway
- **Health check:** /api/health
- **Public domain:** Yes

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

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18.6@sha256:4fc833b43d2aaf6ecc9b18615f5533602b723a32d0e2efe2dae8ca0f7217c863

## Buckets

- **Bucket**

## Documentation

# Deploy and Host Kaneo with Railway

Kaneo is an open-source project management tool with kanban boards, list and timeline views, time tracking, labels, comments and integrations. This template runs Kaneo 2.50 with PostgreSQL 18 and a Railway Bucket for task images and attachments, and creates your admin account before the site goes online.

## About Hosting Kaneo

Kaneo ships as one container: a Node.js API and an nginx server for the web app. The API applies its database migrations on start and keeps all data in PostgreSQL. Uploads go straight from the browser to S3-compatible storage through short-lived signed URLs; the bucket stays private and Kaneo checks access before serving a file.

On Railway the template adds a small start script. It creates the first admin from template variables while the public port is still closed, so nobody can claim a fresh instance before you. It also sets the Bucket's CORS rule for your domain, so uploads work without manual storage setup. Registration is closed by default; you add teammates yourself.

## Common Use Cases

- Plan sprints and track tasks on kanban boards for a small team
- Replace Jira, Linear or Trello with a self-hosted tool you control
- Track time per task and keep comments and screenshots next to the work
- Give agents and scripts access through Kaneo's API and built-in MCP endpoint

## Dependencies for Kaneo Hosting

- Kaneo 2.50.0 (`ghcr.io/usekaneo/kaneo`, pinned by digest)
- PostgreSQL 18 (Railway's `postgres-ssl` image)
- A Railway Bucket (S3-compatible) for images and attachments

### Deployment Dependencies

- Kaneo source and releases: https://github.com/usekaneo/kaneo
- Kaneo documentation: https://kaneo.app/docs
- Environment variables: https://kaneo.app/docs/core/installation/environment-variables
- Railway Buckets: https://docs.railway.com/guides/storage-buckets

### Implementation Details

| Service | What it does | Public |
|---|---|---|
| Kaneo | API + web app (nginx on port 5173), migrations on start | yes |
| Postgres | All Kaneo data | no |
| Bucket | Task images and attachments (private, signed URLs) | no |

**First login**

1. Open the **Kaneo** service's public URL.
2. Sign in with `KANEO_ADMIN_EMAIL` (default `admin@example.com`) and the generated `KANEO_ADMIN_PASSWORD` from the Kaneo service's Variables tab.
3. Create a workspace, then change your e-mail and password under your profile settings.

**Adding teammates.** `DISABLE_REGISTRATION=true` means strangers cannot sign up. As the instance admin you can create accounts under Admin > Users, or invite people to a workspace (invitation e-mails need SMTP; invited addresses can also register directly). Set `DISABLE_REGISTRATION=false` to open sign-up.

**E-mail (optional).** Kaneo sends invitations and password resets over SMTP only. Set the `SMTP_*` variables; Railway allows outbound SMTP on the Pro plan. `DISABLE_EMAIL_OTP_SIGN_IN=true` keeps password sign-in once SMTP is configured.

**Uploads.** The Bucket variables are filled in for you. On every start the Kaneo service sets the Bucket's CORS rule to `KANEO_CLIENT_URL`. The default size limit is 10 MiB (`S3_MAX_IMAGE_UPLOAD_BYTES`).

**Custom domain.** Add the domain to the Kaneo service, set `KANEO_CLIENT_URL` to `https://{your-domain}` and redeploy; the API URL and the Bucket CORS rule follow it.

**Scaling.** One replica is enough for most teams. To run several replicas, add a Redis service and set `REDIS_URL` on Kaneo so live updates reach every replica.

**Versions.** The image is pinned in `services/kaneo/Dockerfile` (`KANEO_IMAGE`, tag and digest). To upgrade, change the tag and digest to a newer release from the Kaneo releases page and redeploy; migrations run automatically. Back up Postgres first.

**Resources.** Measured on Railway: Kaneo about 0.31 GB RAM idle, Postgres about 0.10 GB, near-zero CPU. Fits the Trial, Hobby and Pro plans; expect roughly $4-6 per month for a small team.

This is a community template; it is not affiliated with the Kaneo project.

### Why Deploy Kaneo on Railway?

Railway runs Kaneo, its database and its file storage as one project with private networking, managed volumes and HTTPS. You get a working instance with a secure admin login in a few minutes, and you can add a custom domain, scale up or upgrade the pinned version from the dashboard.


## 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)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/kaneo-2-project-management-postgres-s3-u
