A self-hosted task management board that stores tasks as Markdown files in a simple directory structure.
Tasks.md is a self-hosted task management board that stores tasks as Markdown files in a directory-based structure. It provides a web interface for organizing tasks into lanes (directories) and cards (files), allowing users to manage their workflow without relying on external services. The application is designed to be lightweight, customizable, and easy to deploy using Docker.
Developers, technical teams, and individuals who prefer plain-text task management, want full control over their data, and need a simple, self-hosted alternative to cloud-based task boards.
Tasks.md offers a unique combination of a modern web interface with a file-based backend, making tasks editable with any text editor and versionable with Git. Its self-hosted nature ensures data privacy, while Docker deployment simplifies setup and maintenance.
A self-hosted, Markdown file based task management board
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Tasks are stored as Markdown files, enabling rich formatting and easy editing with external text editors, which simplifies version control and backup.
Deployment is straightforward with a single Docker image or docker-compose, requiring minimal configuration for self-hosting, as shown in the README with clear environment variables.
Includes built-in color themes (Adwaita, Nord, Catppuccin) and allows CSS overrides via a custom.css file, offering deep UI customization without code changes.
The web interface is installable as a Progressive Web App with responsive design and light/dark theme sync, enhancing accessibility on various devices.
The project deliberately maintains a narrow scope, lacking advanced task management features such as calendar integration, notifications, or complex workflows, as admitted in the README's low maintenance philosophy.
When using BASE_PATH for subpath deployments, Progressive Web App functionality is disabled, limiting offline use and installability in those configurations, as noted in the environment variables section.
Since tasks are plain files without built-in locking mechanisms, simultaneous edits by multiple users can lead to data conflicts or loss, especially in team environments.