ConfigsApr 16, 2026·3 min read

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.

TL;DR
Planka is a free, open-source, self-hosted Trello alternative with real-time kanban boards and multi-user collaboration.
§01

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.

§02

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.

§03

How to use

  1. Download the official docker-compose.yml from the Planka repository.
  2. Run docker compose up -d to start Planka with PostgreSQL.
  3. Open http://localhost:1337 and log in with the default credentials (demo@demo.demo / demo).
§04

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:
§05

Related on TokRepo

§06

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

How does Planka compare to Trello?+

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.

Can Planka handle multiple projects?+

Yes. Planka supports multiple projects, each with its own set of boards. Users can be assigned to specific projects with role-based access control.

Does Planka support mobile devices?+

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.

Is there an API for Planka?+

Planka provides a REST API that mirrors its web interface functionality. You can create boards, cards, and manage users programmatically through HTTP endpoints.

What resources does Planka require?+

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)

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets