Changelog

Bug Fixes

• web: use location.href for the sign-in redirect param: 7483d37

Features

• mattermost: add native Mattermost integration: #1325
• center Gantt view on today by default: #1686
• task item counters: #1638
• i18n: add polish locale: #1639
• i18n: add Japanese (ja-JP) translation: #1662

Bug Fixes

• ci: preserve OpenAPI checker argument boundaries: #1657
• web: preserve imported label colors: #1695
• project nav width in different language: #1641
• make task removal discoverable and calendar states distinct: #1685
• web: protect unsaved task input: #1694
• auth: prevent 401 retry storm for pending invitations: #1677
• auth: prevent 401 retry storm and redirect to sign-in: #1676
• hide "Mark as planned" for backlog tasks: #1675
• api: close the remaining gaps in the auth schema emitter: #1655
• web: resolve the root error boundary's translation keys: #1648
• api: replace the seat-reconciliation advisory lock with a job lease: cf701d0
• api: close five workspace-scoping gaps: #1646
• api: correct five defects that fail silently: #1647
• api: make notifications and seat reconciliation survive replicas: #1649
• chart: Added more values: #1636
• web: let task labels use card width: #1635

Credits

Huge thanks to @shockalotti, @reachsanjivbhagat-gif, @andrejsshell, @tinsever, @TymekV, @MonsPropre, @krudo-taco, @mohiuddin000, @sinsky, and @hydraxman for helping!

2.22.0 (2026-08-21)

Features

• site: add blog section with alternatives round-ups (ddc242f)

Bug Fixes

• api: return 404 when a label does not exist (442a382)
• ci: stop the release chart gate requesting packages write (6ebb762)

Documentation

• describe the release flow in the agent guide (56a9eab)
• update contributors and sponsors (012778e)

What's Changed

• fix(api): add timeout to Turnstile verification by @sentry[bot] in https://github.com/usekaneo/kaneo/pull/1623
• fix(web,sentry): handle Safari "TypeError: Load failed" network errors by @sentry[bot] in https://github.com/usekaneo/kaneo/pull/1624
• fix(web,sentry): ignore third-party adware/extension errors from cdn77.org by @sentry[bot] in https://github.com/usekaneo/kaneo/pull/1625
• fix(web): prevent auth client timeout by optimizing i18n loading by @sentry[bot] in https://github.com/usekaneo/kaneo/pull/1626
• fix(web): prevent Shiki highlighter crash on stale dynamic module load by @sentry[bot] in https://github.com/usekaneo/kaneo/pull/1627
• fix(web): prevent Tiptap TransformError from duplicate Link extension by @sentry[bot] in https://github.com/usekaneo/kaneo/pull/1629
• refactor: simplify conditional checks with optional chaining and clean up lint warnings by @aoright in https://github.com/usekaneo/kaneo/pull/1613
• fix(api): gzip API responses to shrink large board payloads by @Kampe in https://github.com/usekaneo/kaneo/pull/1631
• fix(web): use fallback MIME type for unknown files by @hydraxman in https://github.com/usekaneo/kaneo/pull/1614
• fix: increase card title font size by @smltr in https://github.com/usekaneo/kaneo/pull/1571
• feat(auth): let admins restrict workspace creation to instance admins by @pesnik in https://github.com/usekaneo/kaneo/pull/1562
• Adds a per-project monthly calendar view alongside board, backlog and gantt. by @fvoci in https://github.com/usekaneo/kaneo/pull/1570
• chore: migrate supported runtime to Node 24 by @N1arko in https://github.com/usekaneo/kaneo/pull/1561
• refactor(planka-import): drop the dead author parameter from formatComment by @andrejsshell in https://github.com/usekaneo/kaneo/pull/1632
• feat: add Coolify deployment support (docker-compose.yml + guide) by @pourmirzai in https://github.com/usekaneo/kaneo/pull/1558
• chore(deps): bump react-email from 5.2.10 to 6.9.2 by @dependabot[bot] in https://github.com/usekaneo/kaneo/pull/1606
• fix(email): let the workspace invitation template render without copy by @andrejsshell in https://github.com/usekaneo/kaneo/pull/1633

New Contributors

• @Kampe made their first contribution in https://github.com/usekaneo/kaneo/pull/1631
• @smltr made their first contribution in https://github.com/usekaneo/kaneo/pull/1571
• @pesnik made their first contribution in https://github.com/usekaneo/kaneo/pull/1562
• @pourmirzai made their first contribution in https://github.com/usekaneo/kaneo/pull/1558

Full Changelog: https://github.com/usekaneo/kaneo/compare/v2.20.0...v2.21.0

What's Changed

• chore(ci): pass Sentry auth token via BuildKit secret, not image env by @randoneering in https://github.com/usekaneo/kaneo/pull/1603
• feat(api,web): runtime Sentry instrumentation by @randoneering in https://github.com/usekaneo/kaneo/pull/1604
• feat(web): source maps + root error boundary for Sentry by @randoneering in https://github.com/usekaneo/kaneo/pull/1602
• feat(sentry): provision alerts and dashboards as code by @randoneering in https://github.com/usekaneo/kaneo/pull/1610
• fix(web,sentry): remove unnecessary Sentry capture for auth fetch errors by @sentry[bot] in https://github.com/usekaneo/kaneo/pull/1615
• fix(sentry): ignore Safari extension runtime.sendMessage() errors by @sentry[bot] in https://github.com/usekaneo/kaneo/pull/1616
• fix(web,sentry): ignore Facebook in-app browser postMessage errors by @sentry[bot] in https://github.com/usekaneo/kaneo/pull/1617
• fix(web,sentry): reduce noise from auth fetch errors and validate API URL by @sentry[bot] in https://github.com/usekaneo/kaneo/pull/1618
• fix(test): stop integration test hook and case timeouts by @randoneering in https://github.com/usekaneo/kaneo/pull/1619
• fix(web): prevent Shiki highlighter crash on dynamic module load failure by @sentry[bot] in https://github.com/usekaneo/kaneo/pull/1622
• fix(web,sentry): handle authClient.getSession() network errors in workspace settings by @sentry[bot] in https://github.com/usekaneo/kaneo/pull/1621

Full Changelog: https://github.com/usekaneo/kaneo/compare/v2.19.1...v2.20.0

Recommended for anyone on v2.19.0.

Task descriptions could be saved to the wrong task (#1599). The description editor saves on a 700ms debounce, and it read the current task when the timer fired rather than when the text was typed. Leaving a task inside that window wrote its text over whichever task you had opened, so both tasks were damaged: the one you arrived at lost its description, and the one you edited never received the change. A second edit inside the same window could also drop the first task's save entirely.

v2.19.0 made this easier to hit, because that release kept the editor alive across task switches. The underlying mistake was older.

Nothing to do beyond upgrading. No migration and no configuration change.

What's Changed

• fix(web): save a description to the task it was typed in by @andrejsshell in https://github.com/usekaneo/kaneo/pull/1600

Full Changelog: https://github.com/usekaneo/kaneo/compare/v2.19.0...v2.19.1

Before you upgrade

Two changes in this release can affect a running install. Both are listed as ordinary fixes below, so they are called out here instead.

Session cookies now set Secure on any HTTPS deployment (#1560). Previously Secure was only set when the API and the web app lived on different subdomains, which meant a same-domain HTTPS install was sending its session cookie in the clear. If KANEO_API_URL starts with https:// but your instance is actually reached over plain HTTP, logins will stop working after this upgrade. The fix is to make KANEO_API_URL match how the instance is really served.

Tasks imported without a priority are repaired on startup (#1594). Issues imported from GitHub or Gitea without a priority: label were stored with no priority at all, and the API rejected every later edit of those tasks with a 400. Dragging such a card between columns appeared to work and silently reverted. The migration sets those rows to the default priority and then makes the column NOT NULL, so it cannot happen again. It runs at API startup and needs a brief exclusive lock on the task table, which is worth knowing if your instance has a very large board.

If you are not using the GitHub or Gitea integration, the second one will not match any rows.

What's Changed

• chore: fix biome lint config for 2.5.x by @randoneering in https://github.com/usekaneo/kaneo/pull/1589
• fix(web): keep task description editor alive across task switches by @ab192130 in https://github.com/usekaneo/kaneo/pull/1581
• fix: GitHub-imported tasks without priority label get priority=null and can never be edited by @ashebanow in https://github.com/usekaneo/kaneo/pull/1583
• fix(github): keep a webhook delivery alive when link metadata will not parse by @luantaraschi in https://github.com/usekaneo/kaneo/pull/1526
• feat(github): move the task back when an issue is reopened by @luantaraschi in https://github.com/usekaneo/kaneo/pull/1518
• fix: derive a project key from non-Latin names by @luantaraschi in https://github.com/usekaneo/kaneo/pull/1517
• fix(auth): secure cookies on HTTPS deployments by @N1arko in https://github.com/usekaneo/kaneo/pull/1560
• [OPEN FOR DISCUSSION!] docs: add AI contribution guidelines by @tinsever in https://github.com/usekaneo/kaneo/pull/1593
• fix(web): respect granular task permissions by @tinsever in https://github.com/usekaneo/kaneo/pull/1520
• fix(task): repair the null priority that blocks every edit, and move tasks by column slug by @andrejsshell in https://github.com/usekaneo/kaneo/pull/1594
• test(web): cover the crash #1580 actually reported by @andrejsshell in https://github.com/usekaneo/kaneo/pull/1595
• feat(api): enrich Sentry with profiling and user attribution by @randoneering in https://github.com/usekaneo/kaneo/pull/1590

New Contributors

• @ab192130 made their first contribution in https://github.com/usekaneo/kaneo/pull/1581
• @ashebanow made their first contribution in https://github.com/usekaneo/kaneo/pull/1583

Full Changelog: https://github.com/usekaneo/kaneo/compare/v2.18.0...v2.19.0

Full Changelog: https://github.com/usekaneo/kaneo/compare/v2.17.6...v2.18.0

Full Changelog: https://github.com/usekaneo/kaneo/compare/v2.17.5...v2.17.6

Full Changelog: https://github.com/usekaneo/kaneo/compare/v2.17.4...v2.17.5