Open-source project
kanbn/kan avatar
kanbn/kan

kanbn/kan: a self-hosted Trello alternative built on Next.js and tRPC

The open source Trello alternative.

6,003 stars546 forksTypeScriptAGPL-3.0

At a glance

What is it?
Kan is an AGPL-3.0 project management board you can run on your own server with Docker Compose. It trades Trello's ecosystem for control of your data, and its integration layer is still listed as coming soon.
Who is it for?
Adopt Kan if you want a Trello-shaped board on infrastructure you control and you are comfortable running Postgres plus two containers. Do not adopt it if you depend on third-party integrations or on a vendor handling upgrades for you, because the README still lists integrations as coming soon and there is no documented rollback path.
Can I use it commercially?
Yes, with strict conditions. AGPL-3.0 is a network copyleft licence: if people use a modified version over a network, for example as a hosted service, you must offer them its source code under the same licence.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly TypeScript, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • kanbn/kan6,003 ★ · +313
Star history
Repository2026-09-242026-11-15
kanbn/kan5.7k6k

313 Stars in the last 52 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

The problem Kan targets: Trello's model without Trello's hosting

Kan is a board-based project management tool. Cards move between lists, boards carry visibility settings, workspaces hold members, and cards collect labels, comments and an activity log. That is the Trello vocabulary almost verbatim, and the README says so directly: Kan is "The open-source project management alternative to Trello." The audience is therefore narrow and specific. It is for a team that already thinks in boards and cards, wants the data on hardware it controls, and is willing to run a web application plus a database to get that. It is not a general-purpose issue tracker and it is not a document tool. The feature list is deliberately board-centric: board visibility, workspace members, Trello imports, labels and filters, comments, activity log, and reusable board templates. If your workflow does not map onto lists of cards, the product has little to offer you.

Architecture: a Turborepo monorepo with a migration gate in front of the web app

The repository is a pnpm workspace driven by Turborepo, with an apps/ directory and a packages/ directory. The web application is Next.js, the API layer is tRPC, authentication is Better Auth, the ORM is Drizzle. Those are listed in the README's "Made With" section, along with Tailwind CSS and React Email. The deployment shape is the interesting part. The compose file defines three services: postgres, migrate, and web. The migrate service runs the ghcr.io/kanbn/kan-migrate image and waits for Postgres with condition: service_healthy. The README says the compose file sets up Postgres, runs migrations, and starts the web service. The database package is separate, which is why the root package.json exposes a db:migrate script that changes into packages/db before running the migration.

Installing Kan with Docker Compose and reaching the first board

The README offers two paths. Railway hosts an official one-click template, and Docker Compose is the self-managed path. Start by creating a .env file. The .env.example file names two required values: NEXT_PUBLIC_BASE_URL and BETTER_AUTH_SECRET. The example suggests generating the secret with a shell pipeline, and it also defines POSTGRES_PASSWORD, which the compose file needs because the bundled Postgres service reads it.

bash
openssl rand -base64 26 | tr -dc 'a-zA-Z0-9' | head -c 32

The README's compose configuration wires the web container to port 3000 and maps it through WEB_PORT, defaulting to 3000. The migrate service receives POSTGRES_URL and waits for the Postgres healthcheck. Bring everything up in detached mode.

bash
docker compose up -d

Migrations run first, then the web container starts. The application should be reachable at http://localhost:3000, or at whatever port you set in WEB_PORT. To follow startup, use docker compose logs -f, or narrow it with docker compose logs -f migrate to confirm the migration step finished before the web service came up.

If you prefer to run from source, the README's local development steps are a clone, then pnpm install, then copying .env.example to .env, then pnpm db:migrate, then pnpm dev. The root package.json pins the toolchain: Node >=20.18.1 and pnpm 9.14.2.

bash
pnpm install
pnpm db:migrate
pnpm dev

Once you are in, the README points at Trello imports as a way to bring existing boards across, which is the fastest route to a first real board rather than an empty one you build by hand.

Environment variables decide which features exist at all

Kan is not one binary with optional flags. Several capabilities are compiled into behaviour by presence or absence of configuration. Email is the clearest case: SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD and EMAIL_FROM are all optional, and NEXT_PUBLIC_DISABLE_EMAIL switches email features off entirely. If you set nothing, you get an instance that cannot send mail, which matters for anything that depends on notifications or verification. Redis is similarly optional: REDIS_URL is marked as optional and used for rate limiting. S3 storage is optional too, with S3_ENDPOINT for S3-compatible providers such as MinIO, R2 and Spaces, and S3_REGION described as required for AWS S3 but ignored by most compatible providers. The .env.example also carries NEXT_API_BODY_SIZE_LIMIT, defaulting to 1mb, which is the kind of default you only notice when an upload fails. Treat the .env.example file as the real feature matrix for a self-hosted install.

Where Kan is the wrong tool

The README lists "Integrations (coming soon)" as a feature, which is a frank way of saying the integration surface does not exist yet. If your team's workflow assumes a Trello Power-Up, a calendar sync, or a chat bridge, Kan will not carry it today, and the roadmap link is where the project tracks what is planned. A second limitation is operational. The compose file runs a floating latest tag for both the web and migrate images, and the repository does not document a rollback procedure. There is no described downgrade path if a migration succeeds and the new version misbehaves. A third point is the licence. AGPL-3.0 is a strong copyleft licence, and it is a different proposition from a permissively licensed tool if you intend to modify Kan and expose it to users over a network. Finally, the documentation is thin in places: the README does not document rollback, and it does not describe a backup or restore procedure for the Postgres volume.

How Kan differs from Planka and from Trello itself

The closest comparison in the same category is Planka, another open source, self-hosted board tool. The practical difference visible here is the stack and the deployment ritual. Kan ships a dedicated migration container in its compose file, which runs migrations rather than leaving them to an operator. Kan's stack is also unambiguously a TypeScript monorepo: Next.js, tRPC, Drizzle, Better Auth, Tailwind, Turborepo. That matters if you plan to contribute or fork, because the codebase will feel familiar to a Next.js developer and foreign to someone who prefers a smaller server-rendered application. Against Trello, the difference is not features but ownership. Trello gives you an ecosystem, hosted upgrades and an integration directory. Kan gives you the database file, the containers and the responsibility. The README's own framing, an "open-source project management alternative to Trello," is honest about which half of that trade you are taking.

Maintenance, upgrades and licence cost

The repository is not archived, and the last push was on 2026-11-02. Releases are tagged and dated: v0.6.0 on 2026-06-29, v0.5.6 on 2026-03-19 and v0.5.5 on 2026-03-12. The version numbering sits below 1.0, which is worth weighing if you are putting a team's daily work into it. Upgrading means pulling new images, letting the migrate container run, and starting the web container again; nothing in the README describes how to reverse it. Releases are tagged on GitHub, so checking the release you are moving to is the concrete pre-upgrade step. On licensing, Kan is AGPL-3.0. That is a copyleft licence with a network clause, and it is a materially different obligation from MIT or Apache-2.0 if you modify the code and let users interact with it over a network. Whether that affects your organisation is a question for your own counsel, not for this article.

Editorial conclusion

Adopt Kan if you want a Trello-shaped board on infrastructure you control and you are comfortable running Postgres plus two containers. Do not adopt it if you depend on third-party integrations or on a vendor handling upgrades for you, because the README still lists integrations as coming soon and there is no documented rollback path. Before committing, verify that the ghcr.io/kanbn/kan and ghcr.io/kanbn/kan-migrate images you pull match a release tag you can name, rather than trusting a floating latest tag.

Frequently asked questions

What is kanbn/kan?

It is an open source project management tool that the README describes as the open-source project management alternative to Trello. It is built with Next.js, tRPC, Better Auth, Tailwind CSS and Drizzle ORM, and it is licensed AGPL-3.0.

How do I self-host kanbn/kan?

The README gives two options: a one-click Railway template, or Docker Compose. The compose file defines postgres, a migrate service that runs migrations first, and a web service.

Which environment variables does kanbn/kan require?

The .env.example marks NEXT_PUBLIC_BASE_URL and BETTER_AUTH_SECRET as required, plus POSTGRES_PASSWORD when deploying from Compose. SMTP, S3, Redis and the API body size limit are all optional.

Can kanbn/kan import my existing Trello boards?

Yes. Trello imports are listed among the features in the README, alongside board visibility, workspace members, labels and filters, comments, an activity log and board templates.

What are the main limitations of kanbn/kan?

Integrations are listed as coming soon, so there is no integration surface yet. The compose file also uses a floating latest image tag, and the README does not document a rollback or backup procedure.

Official sources

  1. kanbn/kan on GitHub
  2. License: AGPL-3.0
  3. Project website
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/kanbn-kan.svg)](https://hysenlabs.com/projects/kanbn-kan)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/kanbn-kan.svg)](https://hysenlabs.com/projects/kanbn-kan)

Was this useful?