# Tasks.md

> Self-hosted kanban board that stores cards as Markdown files

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.

- **Category:** To-Do List Apps
- **Made by:** Matheus Baldissara (BaldissaraMatheus)
- **Website:** https://github.com/BaldissaraMatheus/Tasks.md
- **Runs on:** Web
- **Facts last checked:** Oct 9, 2026

## Pricing

Tasks.md is free to use.

- **Pricing model:** 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 https://github.com/BaldissaraMatheus/Tasks.md on Oct 9, 2026. Prices change, so confirm with Tasks.md before buying.

## 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.

## 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.

## Works with

Obsidian

**Tags:** Open source, Self-hostable, Tasks, Kanban boards, Markdown

## Alternatives

- [Vikunja](https://toolgpa.com/tools/vikunja): Open-source task manager to self-host or use as a paid cloud. [Compare](https://toolgpa.com/compare/tasks-md-vs-vikunja)
- [Kanri](https://toolgpa.com/tools/kanri): Offline kanban board app for Windows, macOS and Linux. [Compare](https://toolgpa.com/compare/kanri-vs-tasks-md)
- [myTinyTodo](https://toolgpa.com/tools/mytinytodo): Small open-source to-do list script for your own web server. [Compare](https://toolgpa.com/compare/mytinytodo-vs-tasks-md)
- [tududi](https://toolgpa.com/tools/tududi): Open-source task and life organizer to self-host or use hosted. [Compare](https://toolgpa.com/compare/tasks-md-vs-tududi)
- [TaskTrove](https://toolgpa.com/tools/tasktrove): Self-hosted task manager with list, kanban and calendar views. [Compare](https://toolgpa.com/compare/tasks-md-vs-tasktrove)

## Sources

The prices, plans, platforms and features above were read from these pages on Oct 9, 2026:

- https://github.com/BaldissaraMatheus/Tasks.md
- https://github.com/BaldissaraMatheus

Page: https://toolgpa.com/tools/tasks-md
Listed by ToolGPA (toolgpa.com).