Docker Image Usage

Do not update the software blindly without reading the ChangeLog. Always check for breaking changes.

Docker Registries

Registry Name	Registry URL
Docker Hub	`docker.io/kanboard/kanboard`
GitHub Container Registry	`ghcr.io/kanboard/kanboard`
Quay.io	`quay.io/kanboard/kanboard`

Docker Tags

Tag	Description
`latest`	Latest stable release
`nightly`	Nightly build (latest development changes)
`v1.2.x`	Specific version of Kanboard

It is recommended to always pin a specific version of Kanboard to avoid unexpected upgrades.

Environment Variables

All Kanboard configuration options can be set as environment variables.

Volumes

Path	Description
`/var/www/app/data`	Application data (SQLite database, attachments, etc.)
`/var/www/app/plugins`	Plugins
`/etc/nginx/ssl`	SSL certificates

Custom Config File

The container includes a default config file located at /var/www/app/config.php.
You can store your custom config file in the data volume: /var/www/app/data/config.php.
Restart the container to apply changes to your custom config file.

Running the Container

Basic Usage

docker run -d --name kanboard -p 80:80 -t kanboard/kanboard:v1.2.8

Docker Compose

A docker-compose.yml file is available in the Kanboard repository. Below is an example using SQLite:

version: '2'
services:
  kanboard:
    image: kanboard/kanboard:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - kanboard_data:/var/www/app/data
      - kanboard_plugins:/var/www/app/plugins
      - kanboard_ssl:/etc/nginx/ssl
volumes:
  kanboard_data:
  kanboard_plugins:
  kanboard_ssl:

Another example using MariaDB:

version: '2'
services:
  kanboard:
    image: kanboard/kanboard:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - kanboard_data:/var/www/app/data
      - kanboard_plugins:/var/www/app/plugins
      - kanboard_ssl:/etc/nginx/ssl
    environment:
      DATABASE_URL: mysql://kanboard:kanboard-secret@db/kanboard
  db:
    image: mariadb:latest
    command: --default-authentication-plugin=mysql_native_password
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: kanboard
      MYSQL_USER: kanboard
      MYSQL_PASSWORD: kanboard-secret
    volumes:
      - db:/var/lib/mysql
volumes:
  kanboard_data:
  kanboard_plugins:
  kanboard_ssl:
  db:

Start the container with Docker Compose:

docker compose up

To enable plugin installation (disabled by default for security reasons), use the following example:

docker run --rm \
  --name=kanboard \
  -p 8080:80 \
  -e PLUGIN_INSTALLER=true \
  kanboard/kanboard:latest

Another example with Docker Compose and volumes:

version: '2'
services:
  kanboard:
    image: kanboard/kanboard:latest
    ports:
      - "8080:80"
      - "443:443"
    volumes:
      - kanboard_data:/var/www/app/data
      - kanboard_plugins:/var/www/app/plugins
      - kanboard_ssl:/etc/nginx/ssl
    environment:
      - PLUGIN_INSTALLER=true
volumes:
  kanboard_data:
    driver: local
  kanboard_plugins:
    driver: local
  kanboard_ssl:
    driver: local

Build Your Own Docker Image

Clone the Kanboard repository and run the following command:

make docker-image

Notes

You must use the SMTP method or a plugin like Mailgun/Sendgrid/Postmark to send emails.
The mail and sendmail transports will not work with the official Docker image.