Tasks.md

Open source

Tasks.md is a self-hosted kanban-style task board that stores each card as a Markdown file and each lane as a folder on disk.

Open-source alternative to

hub.docker.com
Tasks.md homepage screenshot
GitHub stars
2.2k
Last 30 days
+18(+1%)
Last commit
8 mo ago
Repository age
3 years
Version
3.3.0
Licence
MIT
Self-hosted
Yes

About Tasks.md

Tasks.md is a task management board you run yourself. Cards are written as Markdown files, and the layout on disk is plain: every lane you add in the app becomes a directory on the filesystem and every task is a file inside it.

It ships as a single Docker image, with a docker run command and a docker-compose example in its documentation. A few optional environment variables set the file owner (PUID and PGID), a title, a base path for running behind a subpath reverse proxy, and how often unused local images are cleaned up.

The interface is described as modern and responsive, follows the operating system's light or dark setting, and can be installed as a PWA. Styling lives in CSS files in the config volume, with Adwaita, Nord, and Catppuccin colour themes included. It can also be run from source with npm.

Key features

  • Cards, lanes, and tags in a responsive interface
  • Each card stored as a Markdown file
  • Installs from a single Docker image
  • Light and dark themes that follow the system setting
  • Three default colour themes: Adwaita, Nord, Catppuccin
  • Subpath reverse-proxy support via a base path variable
  • Can be installed as a PWA

Good fit for

  • Personal task tracking
  • Kanban board on a home server
  • Notes-style cards in Markdown
Tags
kanban
task management
markdown
self-hosted
docker
todo

Tasks.md: questions and answers

What is Tasks.md used for?
Tasks.md is a self-hosted kanban-style task board that stores each card as a Markdown file and each lane as a folder on disk. It is a good fit for personal task tracking, kanban board on a home server and notes-style cards in Markdown.
Is Tasks.md open source?
Yes. Tasks.md is open source under the MIT licence. Its source code is on GitHub at BaldissaraMatheus/Tasks.md and is written mainly in JavaScript.
Is Tasks.md free?
Yes. Tasks.md is open source, so the software itself is free to use.
Can I self-host Tasks.md?
Yes. Tasks.md can be self-hosted on your own server or infrastructure.
What is Tasks.md an alternative to?
Tasks.md is an open-source alternative to Trello. Other open-source alternatives to Trello include WeKan, Planka and Kanboard.
Is Tasks.md actively maintained?
The most recent commit to Tasks.md was on 8 March 2026, and the latest release is 3.3.0, published on 8 March 2026. The project has 2.2k stars on GitHub, with 18 added in the last 30 days.

Open-source alternatives to Tasks.md

See all

SaaS alternatives to Tasks.md

See all