Kan

This template deploys a self-hosted instance of Kan with PostgreSQL on Zeabur.

Kan is an open-source project management tool — a self-hostable alternative to Trello.

Features

• Board Visibility: Control who can view and edit your boards
• Workspace Members: Invite members and collaborate with your team
• Trello Imports: Easily import your Trello boards
• Labels & Filters: Organise and find cards quickly
• Comments: Discuss and collaborate with your team
• Activity Log: Track all card changes with detailed activity history
• Templates: Save time with reusable custom board templates

Services

This template includes three services:

• PostgreSQL – Persistent database
• Kan Migrate – Runs database migrations once, then can be deleted
• Kan – The main web application

Getting Started

1. Wait for all three services to start
2. Check the Kan Migrate service logs — once you see the migrations complete successfully, you can delete the Kan Migrate service (it has no further purpose and will keep restarting otherwise)
3. Visit your domain to create your account

Required Environment Variables

• NEXT_PUBLIC_BASE_URL – Base URL of your instance (auto-set from your domain)
• BETTER_AUTH_SECRET – Random 32+ character string for session encryption
• POSTGRES_URL – PostgreSQL connection string (auto-generated from the PostgreSQL service)

Optional Configuration

You can customize additional settings including:

• SMTP email – Set EMAIL_FROM, SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD
• Google OAuth – Set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET
• GitHub OAuth – Set GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET
• Discord OAuth – Set DISCORD_CLIENT_ID and DISCORD_CLIENT_SECRET
• Trello Import – Set TRELLO_APP_API_KEY and TRELLO_APP_API_SECRET
• Disable sign-up – Set NEXT_PUBLIC_DISABLE_SIGN_UP=true

For a full list of environment variables, see: https://github.com/kanbn/kan#environment-variables-