mrkeyoor.com_
Sun 16 Aug 19:35 UTC
Self-Hostedevaluationupdated 16 Aug 2026

planka

PLANKA is a self-hosted project-management application centered on shared Kanban boards, cards, lists, comments, and real-time updates. It gives teams a polished Trello-style workspace while keeping the application, PostgreSQL database, and uploaded files on infrastructure they control.

Verdict

PLANKA is one of the nicest self-hosted Kanban experiences for an internal team, and its Docker deployment is practical. The catch is commercial, not cosmetic: Community is source-available fair-code, client collaboration can require a paid license, and SSO has moved to Pro. Choose it when that boundary fits, then pin releases, back up both database and files, and treat every major upgrade as an operations change.

Setup4/5Good Compose path, with normal HTTPS, storage, and backup work
Docs4/5Strong deployment guides, though the README itself is very thin
Community4/5Large user base and current work, alongside a very large issue queue
Maturity4/5Established product with backups and releases, but sharp upgrades

Who it’s for

Internal teams that want a polished, multilingual Kanban application under their own operational control.
Small organizations comfortable running Docker Compose, PostgreSQL, HTTPS, backups, and routine updates.
Developers who need an API, webhooks, Markdown cards, attachments, and configurable notifications around a visual board.
Companies whose use remains inside one legal entity and fits the Community license.

Who it’s NOT for

Agencies or consultants inviting paying clients into a Community instance: the license guide says third-party access in a commercial relationship requires a Pro or Enterprise license.
Teams that require OIDC or SSO in the free edition: release 2.2.0 removed it from Community, deactivates SSO-only users, and can lock out an SSO-only administrator after an unprepared upgrade.
Organizations needing anonymous public boards: issue 602 has requested account-free board sharing since 2024 and remains open.
Users expecting self-service forgotten-password recovery: issue 335 remains open after nearly four years, although an operator can create or manage an administrator from the server.
Administrators upgrading an old 1.26.2 installation without a tested restore plan: issue 1623 documents a database migration failing on attachment rows with missing sizes.

Setup reality

The Docker Compose path is short and credible: download the supplied file, replace the public base URL and placeholder secret, create an administrator, then start the PLANKA and PostgreSQL containers. A real deployment still needs HTTPS, a reverse proxy with WebSocket support, a database password, persistent storage, SMTP if email matters, outbound-request rules, and scheduled off-host backups. Updates are simple container pulls in the normal case, but the 2.2.0 authentication break and an open old-database migration failure make release notes, backups, and staged upgrade tests mandatory.

A focused Kanban product, not a general work suite

PLANKA gives teams the familiar structure of projects, boards, lists, and cards. Members can drag cards through a workflow, write Markdown descriptions, discuss work, attach files, and see changes arrive in real time. Notifications can be routed through more than 100 providers, and the interface supports multiple languages. The product looks and behaves closer to a hosted commercial board than many self-hosted admin tools.

That focus is a virtue. PLANKA is not trying to combine documents, chat, spreadsheets, and issue tracking in one screen. It is best when the work can be represented as cards moving across columns. An internal editorial calendar, support queue, hiring pipeline, or small development board fits naturally. Teams that need dependencies, portfolio planning, several task views, or deep reporting should compare it with a broader project-management system before migrating.

The application includes an HTTP API and can expose a Swagger specification when configured. Webhooks, attachments, custom fields, Markdown, card aging, notifications, and real-time updates give developers enough surface for useful internal integrations. The current Community release also includes local-account protections such as TOTP two-factor authentication, recovery codes, trusted devices, and inactivity logout.

The license is the deciding constraint

PLANKA calls itself fair-code and source-available. Its Community license permits personal, educational, non-profit, and internal organizational use, including modification and private internal integrations. It is not an OSI-approved open-source license, a distinction the project's own guide states plainly.

The important restriction concerns outside users and commercial gain. The guide says an agency cannot give a paying client an account on its Community instance as part of that relationship. Hosting PLANKA for customers, white-labeling it for money, or using its API as the operational engine of a paid external service also needs a commercial agreement. Internal business use remains free, and companies may sell consulting that helps another organization run its own internal instance.

This line is easy to miss because self-hosting normally suggests freedom to invite whomever the operator chooses. A software team serving only coworkers may never hit it. An agency board shared with clients can cross it immediately. Decide who will log in and which legal entities they belong to before installation, not after the workspace contains years of cards. If the answer is unclear, get written guidance from PLANKA or choose an alternative with a standard open-source license.

Docker makes installation sensible

The official Compose file runs the application beside PostgreSQL and keeps both uploaded data and the database in named volumes. The documented installation asks the operator to generate a long secret, set BASE_URL, create an administrator through a command, and start the services. That is a reasonable first deployment for anyone already comfortable with Docker. A Helm chart and manual installation paths are also documented.

Do not deploy the sample unchanged. Its PostgreSQL service uses trust authentication, and the application example contains an obvious placeholder secret. Production needs a database password, a unique application secret, HTTPS, and a reverse proxy configured for Socket.IO connections. Email notifications require SMTP. File storage can remain local or move to S3-compatible storage, and outbound-request controls need review if the server can reach sensitive internal addresses.

Backups are better documented than in many projects. Supplied scripts export PostgreSQL plus avatars, backgrounds, and attachments into one archive, and a matching restore script is provided. The docs even show cron examples. Operators should still send archives off the host, encrypt them, monitor job failures, and practice a restore. A backup that has never been restored is only a hopeful file.

Version 2.2 demands an upgrade briefing

Release 2.2.0 removed OIDC and SSO from Community and moved them to Pro. Its notes warn that SSO-only accounts are deactivated after the update because those users lack password credentials. If the only administrator signs in through SSO, the operator can lock themselves out unless another administrator is created first. That is a major edition change for teams that selected PLANKA partly for identity-provider integration.

One day later, 2.2.1 shipped as an emergency security release. It fixed path traversal in JWT-protected local-file routes that could let an authenticated user read files available to the PLANKA process. S3-backed storage was not affected. The fast disclosure and patch are good signs, but every local-storage installation on an older version should update promptly.

Older deployments also need more than a blind image pull. Issue 1623 reports an upgrade from 1.26.2 failing when a migration encounters an attachment without a stored size. The normal update guide is only stop, pull, and restart, so a staging copy is the right place to discover data-specific migration failures. Version 2.2 also requires Node.js 24 for source or manual installs, while Docker users are unaffected.

Product gaps and project health

Two long-lived requests expose limits that matter outside a tidy internal team. Anonymous public boards remain an open feature request, so casual viewers need accounts unless another sharing path is built around the system. A forgotten-password request from 2022 also remains open. Administrators have server-side account tooling, but users should not assume the polished interface includes a standard email recovery flow.

The repository was pushed on August 10, 2026, the same day as release 2.2.1, and issue activity continued through August 16. GitHub counted 407 open issues and 39 open pull requests. That queue mixes old feature requests, support questions, bug reports, translations, and active changes, so it is not 446 confirmed defects. It is still a substantial triage burden and means buyers should search their exact workflow before committing.

PLANKA earns a trial for an internal team that wants attractive, responsive Kanban without a hosted vendor. Its deployment docs, backup tools, current releases, and large community are meaningful strengths. The fair-code boundary and recent SSO removal prevent a universal recommendation. Confirm the license fit, test account migration, keep 2.2.1 or newer, and run a representative board for a month before importing the organization's full history.

Alternatives

ProjectWhat it isPick it when
VikunjaAn open-source task manager with list, Kanban, Gantt, table, and calendar views.pick this instead when you want more planning views or an OSI-style license without PLANKA's cross-organization commercial restrictions.
WekanA long-running open-source Kanban application built around boards, lists, and cards.pick this instead when software freedom and a mature Kanban feature set matter more than PLANKA's cleaner interface.
KanboardA deliberately simple PHP Kanban application with plugins and low infrastructure demands.pick this instead when you value a compact server footprint and straightforward task boards over modern real-time presentation.

What people are saying

  1. [github-trending] plankanban/planka

Sources

  1. PLANKA README
  2. PLANKA license guide
  3. PLANKA 2.2.0 release notes
  4. PLANKA 2.2.1 security release
  5. Docker production installation
  6. Issue 1623: failed migration from 1.26.2
  7. Issue 602: public board request