Public | Automated Build

Last pushed: 2 years ago
Short Description
Kanban board based on kanboard.net
Full Description

docker-kanban

Dockerized task organization á la Kanban based upon kanboard.net

Quickstart

docker run -d -p 80:80 mkodockx/docker-kanban

About

What?

Kanboard is a simple visual task board web application.

Have a look at the official website kanboard.net

License

License of kanboard.net is:

GNU Affero General Public License version 3

Summary

  • Inspired by the Kanban methodology
  • Get a visual and clear overview of your project
  • Multiple boards with the ability to drag and drop tasks
  • Minimalist software, focus only on essential features (Less is more)
  • Open source and self-hosted
  • Super simple installation

Live repository status

Travis CI

Scrutinizer CI

Heroku deployment

Who?

kanboard.net is developed by Frédéric Guillot

Where?

Find the official source code at github/fguillot

FAQ

A kanboard.net related FAQ can be found at kanboard.net/faq

Usage

Setup

Minimal

docker run -d mkodockx/docker-kanban

Suggested

docker run -d --name kanban \
    -v /host/persistence/kanban/data:/var/www/html/data \
    -v /host/persistence/kanban/assets:/var/www/html/assets \
    -p 80:80 mkodockx/docker-kanban

Info

By default the standard client design is used. You may want to change parts or more if you have a volume mounted to '/var/www/html/assets'.

Volumes

Data (optional)

The data volume allows to keep the contents created within the application persistent on the host.

Assets (optional)

Within the assets volume mapping you can cutomize styling, fonts and pics of the app.

External database

By default the container uses an embedded SQLite database. You may want to use a PostgreSQL database instead.

Database initialization

Run a database instance first

docker run -d --name db-kanban \
             -v /host/persistence/kanban/db:/data \
             -e USER="kanban"\
             -e DB="kanboard"\
             -e PASS="secret"\
             paintedfox/postgresql

Provide database to docker-kanban

docker run -d --name srv-kanban \
    -v /host/persistence/kanban/data:/var/www/html/data \
    -v /host/persistence/kanban/assets:/var/www/html/assets \
    --link db-kanban:db \
    -e "DATABASE_DRIVER=postgres" \
    -e "DATABASE_USER=kanban" \
    -e "DATABASE_PW=secret" \
    -e "DATABASE_NAME=kanboard" \
    -p 80:80 mkodockx/docker-kanban

Upgrade

  • Stop running sessions

  • Ensure having a backup of your content data to be able to fall back (e.g. by copying the data volume host representation path/directory)

  • If you use own custom assets or changed the provided assets via assets volume, ensure to track them somehow as well

  • Fetch the new container image from registry

    docker pull mkodockx/docker-kanban:latest

  • Start the image as usual providing your data folder from the last version

  • You may need to change its contents in case of data structure modifications

Docker Pull Command
Owner
mkodockx
Source Repository