Planka — Self-Hosted Trello-Like Project Management
Planka is a real-time, self-hosted kanban board for project management with drag-and-drop cards, file attachments, and multi-user collaboration.
Ready-to-run agent install
This asset can be installed after the agent chooses its runtime, checks the plan, and runs the matching command.
npx -y tokrepo@latest install f7aef9df-39c1-11f1-9bc6-00163e2b0d79 --target codexRun after dry-run confirms the install plan.
What it is
Planka is a self-hosted project management tool that provides real-time kanban boards inspired by Trello. It features drag-and-drop cards, file attachments, checklists, labels, due dates, and per-board access control. All data stays on your own server, giving teams full control over their project information.
Planka targets small to mid-sized teams who want Trello-like functionality without subscription fees or third-party data storage. It runs as a Docker Compose stack with a Node.js backend (Sails.js), React frontend, and PostgreSQL database.
How it saves time or tokens
Planka deploys in minutes with a single Docker Compose command. Real-time WebSocket updates mean all team members see board changes instantly without refreshing. The built-in user management eliminates the need for a separate authentication service, and email notifications keep team members informed about assignments and due dates automatically.
How to use
- Download the official docker-compose.yml from the Planka repository.
- Run
docker compose up -dto start Planka with PostgreSQL. - Open
http://localhost:1337and log in with the default credentials (demo@demo.demo / demo).
Example
# docker-compose.yml for Planka
version: '3'
services:
planka:
image: ghcr.io/plankanban/planka:latest
ports:
- '1337:1337'
environment:
BASE_URL: http://localhost:1337
SECRET_KEY: your-secret-key-here
DATABASE_URL: postgresql://planka:planka@db:5432/planka
depends_on:
- db
db:
image: postgres:16-alpine
environment:
POSTGRES_DB: planka
POSTGRES_USER: planka
POSTGRES_PASSWORD: planka
volumes:
- db-data:/var/lib/postgresql/data
volumes:
db-data:
Related on TokRepo
- AI Tools for Task Management -- explore task management tools that integrate with AI workflows
- AI Tools for Self-Hosted -- discover self-hosted applications for team productivity
Common pitfalls
- The default credentials must be changed immediately after first login; leaving demo accounts active is a security risk.
- Planka stores file attachments on the local filesystem by default; configure external storage for production deployments to avoid data loss.
- PostgreSQL backups are not configured out of the box; set up pg_dump schedules to protect project data.
Frequently Asked Questions
Planka provides core kanban features similar to Trello: boards, lists, cards, labels, due dates, and checklists. Trello offers more integrations and power-ups. Planka is free, self-hosted, and keeps all data on your server.
Yes. Planka supports multiple projects, each with its own set of boards. Users can be assigned to specific projects with role-based access control.
Planka's web interface is responsive and works on mobile browsers. There is no dedicated mobile app, but the web UI adapts to smaller screens.
Planka provides a REST API that mirrors its web interface functionality. You can create boards, cards, and manage users programmatically through HTTP endpoints.
Planka runs comfortably on a server with 1GB RAM and 1 CPU core for small teams. PostgreSQL is the main resource consumer; allocate more memory for larger databases.
Citations (3)
- Planka GitHub— Planka is a self-hosted kanban board with real-time updates
- Sails.js— Sails.js framework for Node.js backend
- PostgreSQL Docs— PostgreSQL database documentation
Related on TokRepo
Discussion
Related Assets
Vikunja — Self-Hosted Open Source To-Do and Project Management
Vikunja is an open-source task management application written in Go. It offers lists, kanban boards, Gantt charts, and CalDAV sync — a self-hosted alternative to Todoist, Trello, and Asana.
Kimai — Self-Hosted Open Source Time Tracking
A professional time-tracking application for teams and freelancers with project management, invoicing, and detailed reporting, all self-hosted and privacy-respecting.
LibrePhotos — Self-Hosted AI-Powered Photo Management
A self-hosted open-source photo management service with automatic face recognition, object detection, and geolocation tagging powered by machine learning.
Homarr — Customizable Self-Hosted Server Dashboard
Homarr is a sleek, modern dashboard for your self-hosted server that integrates with dozens of services. It provides real-time monitoring widgets, application shortcuts, and Docker container management in one unified interface.