Important
This is a fork. A fork of go-vikunja/vikunja that adds custom fields for tasks through a runtime-loaded plugin. It is maintained independently of upstream and publishes its own Docker images to ghcr.io/itrt4176/vikunja (versioning and releases are described in "About this fork" below).
The custom-fields plugin lives in the vikunja-custom-fields-plugin repository, which also owns the feature's full documentation: installation and configuration, the management UI, and a complete REST API reference. Everything below this notice is upstream Vikunja's README, kept intact.
The task manager you actually own.
If Vikunja is useful to you, please consider supporting the project. You can buy a coffee, sponsor on GitHub or buy a sticker pack. We're also offering a hosted version of Vikunja if you want a hassle-free solution for yourself or your team. If you or your company needs admin panel, audit logs or time tracking, check out Vikunja Pro.
Note
For the development of Vikunja, we're using LLM-Assisted coding tools in various parts of the codebase. Most contributions made @tink-bot are built that way.
This is a fork of go-vikunja/vikunja that adds custom-fields support through a runtime-loaded plugin. It is maintained independently of upstream and publishes its own Docker images.
Fork releases are tagged v<upstream version>.<fork release> — the upstream semver with a fork-release component appended:
| Tag | Meaning |
|---|---|
v2.6.0.1 |
Based on upstream v2.6.0, first fork release |
v2.6.0.2 |
Second fork release on the same upstream base (fork-only fixes) |
v2.7.0.1 |
Upstream v2.7.0 merged in; the fork-release counter resets |
- The fork-release counter starts at
1and resets whenever the upstream base version changes. - Releases move forward only — there are no backport releases from older upstream bases.
- Release tags are annotated. Each tagged release publishes the Docker tags
2,2.6,2.6.0, the exact tag, andlatest; theunstabletag tracks the tip ofcf-main.
Images are published to GHCR only, built on free GitHub-hosted runners for amd64 and arm64:
docker pull ghcr.io/itrt4176/vikunja:latestThe custom-fields plugin is independent software with its own versioning, loaded at runtime — it is deliberately not encoded in the fork's tags. Only the current pairing of fork and plugin is tested and supported; each fork release's notes state the plugin version it was tested with. Check both before upgrading. Full documentation — installation, configuration, the management UI, and the REST API reference — lives in that repo's docs/ folder.
Binary downloads and OS packages (deb/rpm/apk/arch) are not published yet — see the commented jobs in .github/workflows/release.yml for the plan.
If you find any security-related issues you don't want to disclose publicly, please use the contact information on our website.
See the features page on our website for a more exhaustive list or try it on try.vikunja.io!
All docs can be found on the Vikunja home page.
See the roadmap (hosted on Vikunja!) for more!
Please check out the contribution guidelines on the website.
Most of this repository is licensed under AGPL‑3.0‑or‑later.
The contents of desktop/ are licensed under
GPL‑3.0‑or‑later.
Background images from Unsplash are distributed under the Unsplash License. The license requires giving credit to the photographer and Unsplash. See Unsplash’s terms for more information.