Deploying a Kanban-Style Task Board with Markdown Support on NAS
Tasks.md is a tool that combines the simplicity of Markdown with the visual layout of a Kanban board, similar to Trello. It alllows you to manage tasks in a structured yet flexible way, using plain text files that support full Markdown syntax.
To set up Tasks.md on a Synology NAS, start by creating the necessary directory structure in File Station. Navigate to the docker folder and establish the following:
/docker
└── tasks
├── config # For configuration files
└── tasks # For storing task data in Markdown format
Open Container Manager and go to the Projects section. Click "Create" to start a new project:
- Project Name:
tasks - Path: Select the newly created
/docker/tasksdirectory - Source: Create a docker-compose.yml file
Insert the following configuration into the docker-compose.yml:
services:
tasks-app:
image: baldissaramatheus/tasks.md
container_name: tasks-app
ports:
- 8003:8080 # Customize the first port as needed; 8080 must remain unchanged
volumes:
- ./tasks/:/tasks/
- ./config/:/config/
restart: unless-stopped
Enable the option to configure a web portal through Web Station during setup.
In Web Station, switch to the Web Portal tab and add a new portal. Associate it with the tasks container. Choose "Port-based" as the portal type and set up an HTTP port, such as 2313.
After deployment, access the interface by entering NAS_IP:2313 in a browser. You will see a minimalistic interface. Click "New lane" to create columns for organizing tasks, such as "Urgent," "Today," or "Backlog."
Add tasks by clicking the "+" button within a lane. Each task item supports complete Markdown features, including bold text, lists, and code blocks, allowing for detailed descriptions.
A key feature is the ability to edit the .md files directly in the NAS backend using tools like File Station. Changes made to these files are automatically synchronized and reflected in the web intterface.
This setup provides a lightweight, self-hosted task management solution that leverages the NAS for data storage and accessibility.