PLANKA

Kanban boards for teams, with real-time updates, like Trello

  • ghcr.io/hsinghhira/planka:1.0.1
  • v2.3.1
  • Updated 21 Nov 2026
  • port 6762
  • amd64 · arm64
  • Productivity
  • 12.7k stars

Screenshots

PLANKA screenshot 1: Boards in action

Open the app

Web UI

http://localhost:6762/

About PLANKA

PLANKA is a kanban board app like Trello. Make projects and boards, drag cards between lists, and see what others change right away. PostgreSQL is built in, so it is one container with nothing else to set up.

Features

  • Projects, boards, lists and cards with drag and drop
  • Live updates: everyone sees changes at once
  • Due dates, labels, checklists, attachments and comments
  • Card members, stopwatch and notifications
  • Markdown in descriptions and comments
  • Users with roles, in many languages

How to use

  1. Set BASE_URL to your server's address before you install.
  2. Open PLANKA from your dashboard.
  3. Sign in with the admin email and the password from the app's logs (the box marked CREDENTIALS).
  4. Make a project, then a board, then add lists and cards.
  5. Under Administration, add the people who should work with you.

Before you install

You must set BASE_URL first. It starts as http://[ZIMAOS-IP-ADDRESS]:6762: replace [ZIMAOS-IP-ADDRESS] with your ZimaOS IP, like http://192.168.1.20:6762. PLANKA only accepts browsers at that exact address; at any other address the page loads and the boards don't. For a domain, use https://boards.example.com, or list both with a comma. The admin account is DEFAULT_ADMIN_EMAIL ([email protected] unless you change it) with a password made on first start, shown in the app's logs in the box marked CREDENTIALS and saved in /DATA/AppData/planka/data/.admin_password. To change it, set DEFAULT_ADMIN_PASSWORD. Email and the other settings are in the Variables tab and are added in the app settings. The first start takes about 2 minutes.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone.
BASE_URLhttp://[ZIMAOS-IP-ADDRESS]:6762Required. Replace [ZIMAOS-IP-ADDRESS] with your ZimaOS IP, like http://192.168.1.20:6762. PLANKA only works at this exact address. For a domain use https://boards.example.com; for both, put them side by side with a comma.
DEFAULT_ADMIN_EMAIL[email protected]The admin's email. PLANKA keeps this account as the main admin and you can't edit it in the app while this is set.
DEFAULT_ADMIN_PASSWORD—The admin's password. Leave it empty and one is made for you: it is shown in the app's logs, in the box marked CREDENTIALS. Set it here to change it; PLANKA applies it on every start.

Sign-up and accounts

VariableDefault valueDescription
DEFAULT_ADMIN_USERNAMEadminThe admin's user name, for signing in without the email.
DEFAULT_ADMIN_NAMEAdminThe name shown for the admin.

Server

VariableDefault valueDescription
SECRET_KEY—The key that signs sign-ins. It is made on first start and kept in /data/secrets.env. Only set it to use your own.
TOKEN_EXPIRES_IN365How many days people stay signed in.
TRUST_PROXYfalseSet to true when PLANKA is behind a reverse proxy.
DEFAULT_LANGUAGEen-USThe language for new users and notifications, like de-DE or fr-FR.
MAX_UPLOAD_FILE_SIZE—The biggest attachment people can upload, in bytes. Leave it out for no limit.

Email (SMTP)

VariableDefault valueDescription
SMTP_HOST—Your email server, like smtp.gmail.com. Set it to send notification emails; leave it out to set email up in the app instead.
SMTP_PORT587Your email server port, usually 587 or 465.
SMTP_SECUREtruetrue for port 465. Set to false for port 587.
SMTP_USER—The user name for your email server.
SMTP_PASSWORD—The password for your email server.
SMTP_FROM—Who emails come from, like PLANKA <[email protected]>.

Logs

VariableDefault valueDescription
LOG_LEVELinfoHow much PLANKA writes to the log: error, warn, info or debug.
docker-compose.yml
name: planka

services:
  planka:
    image: ghcr.io/hsinghhira/planka:1.0.1
    container_name: planka
    restart: unless-stopped
    stop_grace_period: 90s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - BASE_URL=http://[ZIMAOS-IP-ADDRESS]:6762
      - [email protected]
      - DEFAULT_ADMIN_PASSWORD=
    ports:
      - target: 1337
        published: "6762"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /data
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/AppData/$AppID/uploads
        target: /app/data
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "node", "/app/healthcheck.js"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 180s
    deploy:
      resources:
        limits:
          cpus: "2.00"
          memory: 1024M
        reservations:
          cpus: "0.10"
          memory: 256M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/planka/icon.png
    x-casaos:
      id: com.icestore.planka
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
        - container: BASE_URL
          description:
            en_US: >-
              Required. Replace [ZIMAOS-IP-ADDRESS] with your ZimaOS IP, like
              http://192.168.1.20:6762. PLANKA only works at this exact
              address. For a domain use https://boards.example.com; for
              both, put them side by side with a comma.
        - container: DEFAULT_ADMIN_EMAIL
          description:
            en_US: >-
              The admin's email. PLANKA keeps this account as the main admin
              and you can't edit it in the app while this is set.
        - container: DEFAULT_ADMIN_PASSWORD
          description:
            en_US: >-
              The admin's password. Leave it empty and one is made for you:
              it is shown in the app's logs, in the box marked CREDENTIALS.
              Set it here to change it; PLANKA applies it on every start.
      ports:
        - container: "1337"
          description:
            en_US: PLANKA web UI and API, published on host as 6762
      volumes:
        - container: /data
          description:
            en_US: >-
              The PostgreSQL database with every board, card and user, and
              secrets.env with this install's own SECRET_KEY and database
              password. Back it up.
        - container: /app/data
          description:
            en_US: >-
              Attachments, avatars and board backgrounds. Back it up.

x-casaos:
  id: com.icestore.planka
  architectures:
    - amd64
    - arm64
  main: planka
  author: HSinghHira
  category: Productivity
  developer: PLANKA Software
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/planka/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/planka/screenshot-1.gif
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/planka/screenshot-1.gif
  title:
    en_US: PLANKA
  tagline:
    en_US: Kanban boards for teams, with real-time updates, like Trello
  description:
    en_US: >-
      PLANKA is a kanban board app like Trello. Make projects and boards,
      drag cards between lists, and see what others change right away.
      PostgreSQL is built in, so it is one container with nothing else to set
      up.


      **Features**


      - Projects, boards, lists and cards with drag and drop

      - Live updates: everyone sees changes at once

      - Due dates, labels, checklists, attachments and comments

      - Card members, stopwatch and notifications

      - Markdown in descriptions and comments

      - Users with roles, in many languages


      **How to use?**


      1. Set BASE_URL to your ZimaOS address before you install.

      2. Open PLANKA from the ZimaOS dashboard.

      3. Sign in with the admin email and the password from the app's logs
         (the box marked CREDENTIALS).

      4. Make a project, then a board, then add lists and cards.

      5. Under Administration, add the people who should work with you.
  tips:
    before_install:
      en_US: >-
        1. You must set BASE_URL first, or the boards won't load. It starts as
           http://[ZIMAOS-IP-ADDRESS]:6762 and you replace
           [ZIMAOS-IP-ADDRESS] with your ZimaOS IP, like
           http://192.168.1.20:6762 for example.


        2. Set DEFAULT_ADMIN_EMAIL to your email if you like.


        3. More settings, like email and the upload size, are listed on the
           PLANKA page at https://icestore.hsinghhira.me/app/planka/
           (Variables tab). You can add them now or later in the app
           settings.


        4. Start the installation. The first start takes about 2 minutes.


        5. Open the app's logs. Find the box marked CREDENTIALS. It has the
           admin email and password.


        6. Open the address you put in BASE_URL and sign in.
  index: /
  port_map: "6762"
  scheme: http
  is_uncontrolled: false
  version: "2.3.1"
  update_at: "2026-11-21"
  release_notes:
    en_US: |-
      - Fixed the first start failing with "extension pg_trgm is not available": the PostgreSQL extensions package is now included (image 1.0.1)
      - First IceStore release, on port 6762
      - Built on ghcr.io/plankanban/planka 2.3.1, with PostgreSQL 16 added inside the same container
      - Each install makes its own SECRET_KEY, database password and admin password on first start; the login is in the CREDENTIALS box in the logs
  repo: "https://github.com/plankanban/planka"
  support: "https://github.com/plankanban/planka/issues"
  docs: "https://docs.planka.cloud/"

Install PLANKA

Something not working with PLANKA?

Report it so it gets fixed, or ask for an app that is not here yet.

More Productivity apps

See all