How to run Kanboard with Docker?

Kanboard can run easily with Docker.

The image size is approximately 70MB and contains:

The Kanboard cronjob is also running everyday at midnight. URL rewriting is enabled in the included config file.

When the container is running, the memory utilization is around 30MB.

Use the stable version

To fetch the latest stable release of Kanboard use the tag stable:

docker pull kanboard/kanboard
docker run -d --name kanboard -p 80:80 -t kanboard/kanboard:stable

Use the development version (automated build)

Every new commit on the repository trigger a new build on the Docker Hub.

docker pull kanboard/kanboard
docker run -d --name kanboard -p 80:80 -t kanboard/kanboard:latest

The tag latest is the development version of Kanboard, use at your own risk.

Build your own Docker image

There is a Dockerfile in the Kanboard repository to build your own image. Clone the Kanboard repository and run the following command:

docker build -t youruser/kanboard:master .

or

make docker-image

To run your container in background on the port 80:

docker run -d --name kanboard -p 80:80 -t youruser/kanboard:master

Volumes

You can attach 2 volumes to your container:

  • Data folder: /var/www/app/data
  • Plugins folder: /var/www/app/plugins

Use the flag -v to mount a volume on the host machine like described in official Docker documentation.

Upgrade your container

  • Pull the new image
  • Remove the old container
  • Restart a new container with the same volumes

Environment variables

The list of environment variables is available on this page.

Config files

  • The container already include a custom config file located at /var/www/app/config.php.
  • You can store your own config file on the data volume: /var/www/app/data/config.php.

References