ScriptsApr 17, 2026·3 min read

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.

TL;DR
WeKan is an open-source self-hosted Kanban board with boards, lists, cards, swimlanes, WIP limits, and full data control.
§01

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.

§02

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.

§03

How to use

  1. 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
  1. Open http://localhost:8080, register an admin account, and create your first board.
  1. Add lists (To Do, In Progress, Done), create cards, and assign team members.
§04

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"}'
§05

Related on TokRepo

§06

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

Is WeKan free?+

Yes. WeKan is open source under the MIT license. Self-hosted deployments are completely free. There are no premium tiers or feature gates.

How does WeKan compare to Trello?+

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.

Does WeKan support swimlanes?+

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.

Can I set WIP limits in WeKan?+

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.

Does WeKan have a REST API?+

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)

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets