Tasks.md
Self-hosted kanban board that stores cards as Markdown files
What is Tasks.md?
Tasks.md is an open-source, self-hosted task board that keeps its data as plain files. Every lane on the board is a directory and every card is a Markdown file, so the same tasks can be read in a text editor or in a notes app such as Obsidian. It installs from a single Docker image, runs in the browser and can be added to a device as a PWA.
Tasks.md is free to use. See every plan
Good for
- Self-hosters who want a task board on their own server
- People who keep tasks as plain Markdown files
- Homelab users who deploy apps with Docker
Worth knowing
- There is no hosted version: someone has to run the Docker image or the source code on a server.
- The README mentions no user accounts or sign-in, so restricting access is left to the host.
- The maintainer calls it a low-maintenance project and keeps the scope of features narrow on purpose.
- Installing as a PWA does not work when BASE_PATH is set to anything other than the root path.
Key features
- Board of lanes, cards and tags
- Cards, lanes and tags are created in a responsive web interface, and the color settings cover tag colors and highlights for due dates that are today or past.
- Cards are Markdown files
- Every lane added in the app is a directory on disk and every task is a Markdown file inside it, so tasks can be edited outside the app.
- Single Docker image
- One docker run command or a short docker-compose file starts the app on port 8080, with one volume for tasks and one for configuration.
- Sub-directories as projects
- Opening the app under a sub-path, such as /backlog, treats that directory as a separate project with its own lanes and tasks.
- Themes and custom CSS
- Light and dark modes follow the operating system, three color themes ship by default (Adwaita, Nord and Catppuccin), and a custom.css file overrides the colors.
- PWA, languages and reverse proxy
- The app can be installed as a PWA, picks its language from the browser, and takes a BASE_PATH variable for running behind a sub-path reverse proxy.
Tasks.md pricing
- Starts at
- Free
- Free plan
- Tasks.md is free, open-source software under the MIT license with no paid plans. The user supplies the server, and the maintainer accepts one-time sponsorship donations.
- Free trial
- None listed
| Plan | Price | What you get |
|---|---|---|
| Free | $0 | The full board, self-hosted from the project's Docker image or run from the source code. |
Read from github.com on Oct 9, 2026. Prices change, so confirm with Tasks.md before you buy.
Works with
Tasks.md alternatives
- Tasks.md vs Vikunja
Free plan · from €4/mo
- Tasks.md vs tududi
Free plan · from €5/mo
- Tasks.md vs TaskTrove
Free plan · from $129 one-time
Common questions
Is Tasks.md free?
Yes. Tasks.md is free to use. Tasks.md is free, open-source software under the MIT license with no paid plans. The user supplies the server, and the maintainer accepts one-time sponsorship donations.
How much does Tasks.md cost?
Tasks.md lists one plan. Free: $0. Prices were read from github.com on Oct 9, 2026.
What platforms does Tasks.md work on?
Tasks.md is available on Web.
Does Tasks.md have an Android app?
No Android app was listed when its pages were read on Oct 9, 2026. Tasks.md is listed for Web.
Does Tasks.md have an iPhone app?
No iPhone app was listed when its pages were read on Oct 9, 2026. Tasks.md is listed for Web.
Is Tasks.md open source?
Yes. Tasks.md is open source, according to its own site. It can also be run on a server of your own.
What does Tasks.md integrate with?
Tasks.md's listing names Obsidian. A listing names up to eight integrations, so it may connect to more.
Who makes Tasks.md?
Tasks.md is made by Matheus Baldissara (BaldissaraMatheus).
What are the alternatives to Tasks.md?
The closest alternatives to Tasks.md in our directory are Vikunja, Kanri, myTinyTodo, tududi and TaskTrove. Each one has a side-by-side comparison with Tasks.md.
Sources for this page
The prices, plans, platforms and features above were read from these pages on Oct 9, 2026.