# Deploy and Host kan.bn on Railway **kan.bn** is a modern, open-source Kanban board application that brings powerful project management to your team. With features like board visibility controls, workspace collaboration, Trello imports, labels & filters, comments, and detailed activity logging - all while maintaining full control over your data. ## About Hosting kan.bn ### Post-Deployment Setup Once both services are running: 1. Click on the `kanbn` service and visit the `.railway.app` domain generated for it — you can also generate your own if you’d like! 2. Click on the **Get started** button to create an account. The first account created will be the admin account. ## Dependencies for kan.bn Hosting ### Deployment Dependencies | Service | Version | Purpose | Source Image | | --- | --- | --- | --- | | kan.bn | latest | Kanban board application | [GitHub](https://github.com/kanbn/kan/pkgs/container/kan) | | PostgreSQL | 16 | Database with SSL | [railwayapp-templates](https://github.com/railwayapp-templates/postgres-ssl/pkgs/container/postgres-ssl) | ### Environment Variables **Core Configuration (Required)** | Variable | Required | Default Value & Description | | --- | --- | --- | | `NEXT_PUBLIC_BASE_URL` | Yes | `https://${{RAILWAY_PUBLIC_DOMAIN}}`
Base URL of your installation | | `BETTER_AUTH_SECRET` | Yes | `${{secret()}}`
Auth encryption secret | | `POSTGRES_URL` | Yes | `${{Postgres.DATABASE_URL}}`
PostgreSQL connection URL | **SMTP Configuration (Optional)** | Variable | Required | Default Value & Description | | --- | --- | --- | | `SMTP_HOST` | No | Empty
SMTP server hostname | | `SMTP_PORT` | No | Empty
SMTP server port | | `SMTP_USER` | No | Empty
SMTP username/email | | `SMTP_PASSWORD` | No | Empty
SMTP password/token | | `SMTP_SECURE` | No | Empty
Use secure SMTP connection (defaults to true if not set) | | `EMAIL_FROM` | No | Empty
Sender email address | **S3 Storage Configuration (Optional)** | Variable | Required | Default Value & Description | | --- | --- | --- | | `S3_REGION` | No | Empty
S3 storage region | | `S3_ENDPOINT` | No | Empty
S3 endpoint URL | | `S3_ACCESS_KEY_ID` | No | Empty
S3 access key | | `S3_SECRET_ACCESS_KEY` | No | Empty
S3 secret key | | `NEXT_PUBLIC_STORAGE_URL` | No | Empty
Storage service URL | | `NEXT_PUBLIC_STORAGE_DOMAIN` | No | Empty
Storage domain name | | `NEXT_PUBLIC_AVATAR_BUCKET_NAME` | No | Empty
S3 bucket name for avatars | **Auth Config (Optional)** | Variable | Required | Default Value & Description | | --- | --- | --- | | `NEXT_PUBLIC_ALLOW_CREDENTIALS` | No | `true`
Allow email & password login | | `NEXT_PUBLIC_DISABLE_SIGN_UP` | No | Empty
Disable sign up | | `BETTER_AUTH_TRUSTED_ORIGINS` | No | Empty
Allowed callback origins | **Integration Providers (Optional)** | Variable | Required | Default Value & Description | | --- | --- | --- | | `TRELLO_APP_API_KEY` | No | Empty
Trello app API key | | `TRELLO_APP_API_SECRET` | No | Empty
Trello app API secret | **OAuth Providers (All Optional)** | Variable | Required | Default Value & Description | | --- | --- | --- | | `GITHUB_CLIENT_ID` | No | Empty
GitHub OAuth client ID | | `GITHUB_CLIENT_SECRET` | No | Empty
GitHub OAuth client secret | | `GOOGLE_CLIENT_ID` | No | Empty
Google OAuth client ID | | `GOOGLE_CLIENT_SECRET` | No | Empty
Google OAuth client secret | | `DISCORD_CLIENT_ID` | No | Empty
Discord OAuth client ID | | `DISCORD_CLIENT_SECRET` | No | Empty
Discord OAuth client secret | | `MICROSOFT_CLIENT_ID` | No | Empty
Microsoft OAuth client ID | | `MICROSOFT_CLIENT_SECRET` | No | Empty
Microsoft OAuth client secret | | `APPLE_CLIENT_ID` | No | Empty
Apple OAuth client ID | | `APPLE_CLIENT_SECRET` | No | Empty
Apple OAuth client secret | | `TWITTER_CLIENT_ID` | No | Empty
Twitter OAuth client ID | | `TWITTER_CLIENT_SECRET` | No | Empty
Twitter OAuth client secret | | `GITLAB_CLIENT_ID` | No | Empty
GitLab OAuth client ID | | `GITLAB_CLIENT_SECRET` | No | Empty
GitLab OAuth client secret | | `GITLAB_ISSUER` | No | Empty
GitLab OAuth issuer | | `REDDIT_CLIENT_ID` | No | Empty
Reddit OAuth client ID | | `REDDIT_CLIENT_SECRET` | No | Empty
Reddit OAuth client secret | | `LINKEDIN_CLIENT_ID` | No | Empty
LinkedIn OAuth client ID | | `LINKEDIN_CLIENT_SECRET` | No | Empty
LinkedIn OAuth client secret | | `SPOTIFY_CLIENT_ID` | No | Empty
Spotify OAuth client ID | | `SPOTIFY_CLIENT_SECRET` | No | Empty
Spotify OAuth client secret | | `TWITCH_CLIENT_ID` | No | Empty
Twitch OAuth client ID | | `TWITCH_CLIENT_SECRET` | No | Empty
Twitch OAuth client secret | | `TIKTOK_CLIENT_ID` | No | Empty
TikTok OAuth client ID | | `TIKTOK_CLIENT_SECRET` | No | Empty
TikTok OAuth client secret | | `TIKTOK_CLIENT_KEY` | No | Empty
TikTok OAuth client key | | `ZOOM_CLIENT_ID` | No | Empty
Zoom OAuth client ID | | `ZOOM_CLIENT_SECRET` | No | Empty
Zoom OAuth client secret | | `VK_CLIENT_ID` | No | Empty
VK OAuth client ID | | `VK_CLIENT_SECRET` | No | Empty
VK OAuth client secret | | `ROBLOX_CLIENT_ID` | No | Empty
Roblox OAuth client ID | | `ROBLOX_CLIENT_SECRET` | No | Empty
Roblox OAuth client secret | | `KICK_CLIENT_ID` | No | Empty
Kick OAuth client ID | | `KICK_CLIENT_SECRET` | No | Empty
Kick OAuth client secret | | `DROPBOX_CLIENT_ID` | No | Empty
Dropbox OAuth client ID | | `DROPBOX_CLIENT_SECRET` | No | Empty
Dropbox OAuth client secret | | `APPLE_APP_BUNDLE_IDENTIFIER` | No | Empty
Apple app bundle identifier | ### Resource Requirements - **Memory**: ~500MB - **CPU**: Minimal - **Storage**: No volume; database grows with usage ## Troubleshooting For common issues and community support, visit the [Railway Community Forum](https://station.railway.com/templates/kan-bn-c9e8686e). ## Template Changelog - **5 July, 2025** - Removed URL-based S3 variables from the template defaults as, despite being empty, they were breaking the installation - Set **Healthcheck Path** to `/` - **3 July, 2025** - Initial template release on Railway --- ## Common Use Cases - **Project Management** - Organize tasks, track progress, and manage deadlines with intuitive Kanban boards - **Team Collaboration** - Invite team members, assign tasks, add comments, and track activity across workspaces - **Trello Migration** - Seamlessly import existing Trello boards while gaining enhanced privacy and control - **Agile Development** - Manage sprints, user stories, and development workflows with labels and filters - **Personal Productivity** - Create private boards for personal task management and goal tracking ## Why Deploy kan.bn 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 kan.bn 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.