Tasks.md
A self-hosted, Markdown file based task management board with Docker support and modern UI.
Smart Download
Visit Project Homepage
No installer available yet — head to the source repository
Self-hosted kanban board where every task is a Markdown file – simple, private, Docker-powered.
Core Features
- Tasks are plain Markdown files – versionable, editable with any tool, independent of the app
- Single Docker command deployment, lightweight and self-contained
- Drag-and-drop lanes, tags, light/dark themes synced with system settings
- PWA installable, multi-language auto-detection
- Three built-in themes (Adwaita, Nord, Catppuccin) plus full CSS customization
What It Can't Do
- •Upgrading from v2.x to v3.x requires manual migration (see migration guide). 2. PWA does not work if BASE_PATH is not '/'. 3. No multi-user support – designed for single user or trusted LAN. 4. No REST API for external integrations. 5. Files must be UTF-8 encoded to display correctly.
Use Cases
- Personal task management with full data ownership and offline access
- Small team kanban over local network – no cloud dependency, easy file sync
- Integration with Obsidian or other Markdown editors for seamless note-taking and task tracking
Tasks.md is a self-hosted task management board that stores every task as a plain Markdown file. It features a modern responsive interface with drag-and-drop lanes, tags, and light/dark themes. The app runs as a single Docker container, supports PWA installation, and automatically detects browser language. It uses Markdown files as the native storage format, making tasks portable, version-controllable, and editable with any text editor. You can organize lanes as directories and tasks as files. Customize with CSS variables, choose from built-in themes (Adwaita, Nord, Catppuccin), or create your own. Ideal for users who want full control over their data without relying on cloud services.
Tags
Getting Started
Download installer
Click the button above to download the installer for your system
Install the software
Double-click the downloaded installer and follow the prompts
Step 1: Run the Docker command (from README), mount /tasks and /config volumes
Step 2: Open http://your-server:8080 in a browser
Step 3: Create lanes and tasks – they automatically appear as folders and .md files on disk
- Step 1: Run the Docker command (from README), mount /tasks and /config volumes
- Step 2: Open http://your-server:8080 in a browser
- Step 3: Create lanes and tasks – they automatically appear as folders and .md files on disk
Checksum not available
This project has not published a SHA-256 checksum on its GitHub Release page
SHA256 Checksum
No checksum available
Download directly from GitHub Releases and verify file integrity yourself
All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.
Open Source Transparency
View GitHub SourceUninstall Info
Stop and remove container: docker stop tasks.md && docker rm tasks.md. Then delete mounted directories /tasks and /config. Warning: all task files will be permanently deleted.
No Extra Dependencies
Ready to use after download. No additional runtime required.
Having issues? Check the FAQ below
5 FAQs
Similar Projects
copyparty
copyparty turns any device into a file server with resumable uploads/downloads using any web browser. Supports HTTP, WebDAV, SFTP, FTP, TFTP, SMB. Only requires Python (2 or 3).
Paperless-ngx
An open-source document management system that turns physical papers into a searchable, organized digital archive. Self-hosted, OCR-powered, and built to eliminate paper clutter forever.
Nextcloud Server
Nextcloud Server is a free, self-hosted productivity platform that puts you in control of your files, contacts, calendars, and communication.