kanbn /kan

The open source Trello alternative.

★ 6,003⑂ 546👁 16⑃ 468● 286▤ 27
TypeScriptAGPL-3.0Created 2023-10-27kan.bn
Download: v0.7.0v0.7.0 ↓0.7.02026-11-04
+6
Daily
6,003
stars
546
forks
16
watchers
468
prs
286
issues
27
releases

README

!github-background


  Kan
  The open-source project management alternative to Trello.



  Roadmap
  ·
  Website
  ·
  Docs
  ·
  Discussions



  


 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
- Integrations (coming soon): Connect your favourite tools

See our roadmap for upcoming features.

 Screenshot



 Made With

- Next.js
- NestJS
- Better Auth
- Tailwind CSS
- Drizzle ORM
- React Email

 Self Hosting

 One-click Deployments

The easiest way to deploy Kan is through Railway. We've partnered with Railway to maintain an official template that supports the development of the project.


  


 Docker Compose

Alternatively, you can self-host Kan with Docker Compose. This will set up everything for you including your postgres database and automatically run migrations.

1. Create a .env file with your environment variables (see Environment Variables section below)

2. Use the docker-compose.yml file provided in the repository, which sets up Postgres, runs migrations, and starts the web service

3. Start the containers in detached mode:

bash
docker compose up -d


The application will be available at http://localhost:3000 (or the port specified in WEB_PORT).

Managing containers:

- To stop the containers: docker compose down
- To view logs: docker compose logs -f
- To restart the containers: docker compose restart
- To rebuild after code changes: docker compose up -d --build

 Local Development

1. Clone the repository (or fork)

bash
git clone https://github.com/kanbn/kan.git


2. Install dependencies

bash
pnpm install


3. Copy .env.example to .env and configure your environment variables
4. Migrate database

bash
pnpm db:migrate


5. Start the development server

bash
pnpm dev


 Environment Variables

At minimum, you'll need:

| Variable               | Description                   | Example                                  |
| ----------------------- | ------------------------------ | ----------------------------------------- |
| POSTGRES_URL          | PostgreSQL connection URL      | postgres://user:pass@localhost:5432/db  |
| NEXT_PUBLIC_BASE_URL  | Base URL of your installation  | http://localhost:3000                   |
| BETTER_AUTH_SECRET    | Auth encryption secret         | Random 32+ char string                    |

Optional integrations (email/SMTP, OAuth and OIDC login, S3-compatible file storage, Trello import, rate limiting, white labelling, and more) are configured through additional variables. See .env.example for the complete list.

 MCP Server

Kan ships with a Model Context Protocol (MCP) server that lets any MCP-compatible AI client (Claude De

Top issues

Discussions

Latest release

v0.7.0 v0.7.0 Pre-release 2026-11-04
What's Changed
 feat: move boards between workspaces by @nickmeinhold in https://github.com/kanbn/kan/pull/458
 fix: correct template creation condition in BoardDropdown by @hjball in https://github.com/kanbn/kan/pull/529
 feat: allow submitting comments via keyboard shortcut by @hjball in https://github.com/kanbn/kan/pull/533
 fix(editor): don't throw in suggestion onExit when no popup was created by @arsteyn in https://github.com/kanbn/kan/pull/543
 fix(mcp): map comment content field for Kan API compatibility by @aeroluxx in https://github.com/kanbn/kan/pull/540
 fix: prevent maximum update

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON