Tasks.md
A self-hosted, Markdown file based task management board
Alternative to: trello
Tasks.md is a self-hosted Kanban board where every lane is a directory and every card is a Markdown file on disk, so there's no database to manage. It supports light and dark themes, several color presets, PWA installation, and reverse-proxy subpaths, all deployable from a single Docker image.
Tasks.md Docker Compose example
Self-host Tasks.md on your own server, homelab, or VPS starting from this Docker Compose example.
It runs Tasks.md in Docker containers using the official baldissaramatheus/tasks.md:latest image, with persistent volumes and automatic restarts preconfigured.
Review the environment variables and adjust them to your setup, save the file as compose.yml (or docker-compose.yml), and start the stack with docker compose up -d.
services:
tasks-md:
image: baldissaramatheus/tasks.md:latest
volumes:
- tasks:/tasks
- config:/config
restart: unless-stopped
environment:
# User ID the application runs as; it owns the files under /tasks and /config.
PUID: "1000"
# Group ID the application runs as.
PGID: "1000"
# Custom name shown in the browser tab and page header. Leave empty for the default ("Tasks.md").
TITLE: ""
# URL subpath to serve under when behind a reverse proxy (e.g. "/tasks"). Leave empty to serve at the root.
BASE_PATH: ""
# How often, in minutes, unreferenced uploaded images are cleaned up. 1440 = every 24h; set to 0 to disable.
LOCAL_IMAGES_CLEANUP_INTERVAL: "1440"
volumes:
tasks:
config:Prefer a managed setup? WinterFlow installs, configures, and updates Tasks.md for you using this same Docker Compose configuration.