WeKan — Open Source Kanban Board for Teams
WeKan is a self-hosted open-source Kanban board that gives teams full control over their project workflows without relying on third-party SaaS platforms.
Ready-to-run agent install
This asset can be installed after the agent chooses its runtime, checks the plan, and runs the matching command.
npx -y tokrepo@latest install d8bc68b6-39f1-11f1-9bc6-00163e2b0d79 --target codexRun after dry-run confirms the install plan.
What it is
WeKan is a self-hosted open-source Kanban board that provides teams with full control over their task management workflow. It offers boards, lists, cards, swimlanes, checklists, due dates, labels, WIP (work-in-progress) limits, and member assignments. WeKan runs on your own infrastructure, keeping all project data under your control.
Teams that need a simple, visual task management tool without SaaS vendor lock-in benefit most. WeKan covers the core Kanban use case -- visualizing work, limiting work in progress, and tracking flow -- without the complexity of full project management suites.
How it saves time or tokens
WeKan provides a focused interface for Kanban workflows. There is no feature bloat -- no Gantt charts, no time tracking, no complex permission hierarchies that slow teams down. The self-hosted approach eliminates per-user pricing and keeps data on your servers. Docker deployment takes minutes. The REST API enables automation for creating cards, moving them between lists, and extracting board data for reporting.
How to use
- Deploy WeKan with Docker:
docker run -d --name wekan-db mongo:6
docker run -d --name wekan \
--link wekan-db:db \
-e MONGO_URL=mongodb://db/wekan \
-e ROOT_URL=http://localhost:8080 \
-p 8080:8080 \
wekanteam/wekan:latest
- Open
http://localhost:8080, register an admin account, and create your first board.
- Add lists (To Do, In Progress, Done), create cards, and assign team members.
Example
# WeKan REST API: Create a card
curl -X POST http://localhost:8080/api/boards/BOARD_ID/lists/LIST_ID/cards \
-H 'Authorization: Bearer TOKEN' \
-H 'Content-Type: application/json' \
-d '{"title": "Fix login bug", "description": "Users report 500 error on /login", "authorId": "USER_ID"}'
# Move a card to a different list
curl -X PUT http://localhost:8080/api/boards/BOARD_ID/lists/LIST_ID/cards/CARD_ID \
-H 'Authorization: Bearer TOKEN' \
-d '{"listId": "NEW_LIST_ID"}'
Related on TokRepo
- Task Management Tools -- Task and project management tools
- Self-Hosted Solutions -- Self-hosted productivity tools
Common pitfalls
- WeKan requires MongoDB. Plan for database backups -- losing the MongoDB data means losing all boards and cards.
- WeKan is Kanban-focused. If your team needs Scrum features (sprints, velocity charts, burndown), consider a more full-featured tool like Huly or Focalboard.
- The web UI works well on desktop but the mobile experience is limited. Mobile users may find the card interactions cumbersome on small screens.
Frequently Asked Questions
Yes. WeKan is open source under the MIT license. Self-hosted deployments are completely free. There are no premium tiers or feature gates.
WeKan provides similar Kanban functionality to Trello: boards, lists, cards, labels, and members. The key difference is WeKan is self-hosted, giving you full data control. Trello offers more integrations and a mobile app but is a commercial SaaS product.
Yes. WeKan supports horizontal swimlanes on boards. Swimlanes let you group cards by category (team, priority, component) within the same board. Each swimlane has its own set of list columns.
Yes. WeKan supports work-in-progress limits on lists. When a list reaches its WIP limit, the list header changes color to signal that no more cards should be added until existing work is completed.
Yes. WeKan provides a REST API for boards, lists, cards, and users. You can automate card creation, status updates, and data extraction through the API. Authentication uses API tokens generated in the user settings.
Citations (3)
- WeKan GitHub Repository— WeKan is a self-hosted open-source Kanban board
- WeKan Official Website— WeKan supports boards, lists, cards, swimlanes, and WIP limits
- WeKan License— MIT license for open-source deployment
Related on TokRepo
Discussion
Related Assets
Medusa — Open Source Headless Commerce Engine
Medusa is an open-source composable commerce engine built with Node.js. Modular architecture, REST & JS SDK, and full customization for building custom storefronts and commerce flows.
Bruno — Open-Source IDE for API Exploration & Testing
Bruno is an open-source IDE for exploring and testing APIs — a lightweight, offline-first alternative to Postman and Insomnia. Stores collections as plain text files in your filesystem so they version-control naturally with Git.
Twenty — Open-Source AI CRM (Salesforce Alternative)
Modern open-source CRM with AI features. Custom objects, kanban views, email sync, workflow automation. NestJS + React + PostgreSQL. AGPL-3.0, 43,700+ stars.
Headscale — Open Source Self-Hosted Tailscale Control Server
Headscale is an open-source implementation of the Tailscale control server. Run your own private mesh VPN with WireGuard, no Tailscale subscription needed.