How to Self-Host Planka Project Board

What Is Planka?

Planka is a self-hosted project management tool with a clean Kanban board interface. It is a lightweight alternative to Trello for small teams.

Requirements

• A Breeze with at least 1 GB RAM
• Docker and Docker Compose

Docker Compose Setup

mkdir -p /opt/planka && cd /opt/planka
cat > docker-compose.yml <<'EOF'
services:
  planka:
    image: ghcr.io/plankanban/planka:latest
    restart: unless-stopped
    ports:
      - "1337:1337"
    environment:
      - BASE_URL=https://board.yourdomain.com
      - DATABASE_URL=postgresql://planka:planka_password@db/planka
      - SECRET_KEY=your-secret-key-min-32-chars-long
      - DEFAULT_ADMIN_EMAIL=admin@yourdomain.com
      - DEFAULT_ADMIN_PASSWORD=changeme
      - DEFAULT_ADMIN_NAME=Admin
      - DEFAULT_ADMIN_USERNAME=admin
    volumes:
      - planka-avatars:/app/public/user-avatars
      - planka-attachments:/app/private/attachments
    depends_on:
      - db

  db:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: planka
      POSTGRES_USER: planka
      POSTGRES_PASSWORD: planka_password
    volumes:
      - planka-db:/var/lib/postgresql/data

volumes:
  planka-avatars:
  planka-attachments:
  planka-db:
EOF

docker compose up -d

Features

• Kanban boards with drag-and-drop
• Multiple projects and boards
• Card labels, due dates, and checklists
• File attachments
• Activity timeline
• User management
• Real-time updates