Skip to content
Kanboard - A recipe to get your personal kanban on


Kanboard is a Kanban tool, developed by FrΓ©dΓ©ric Guillot. (Who also happens to be the developer of my favorite RSS reader, Miniflux)

Sponsored Project

Kanboard is one of my sponsored projects - a project I financially support on a regular basis because of its utility to me. I use it both in my DayJob™, and to manage my overflowing, overly-optimistic personal commitments! πŸ˜“

Features include:

  • Visualize your work
  • Limit your work in progress to be more efficient
  • Customize your boards according to your business activities
  • Multiple projects with the ability to drag and drop tasks
  • Reports and analytics
  • Fast and simple to use
  • Access from anywhere with a modern browser
  • Plugins and integrations with external services
  • Free, open source and self-hosted
  • Super simple installation


  1. Docker swarm cluster with persistent shared storage
  2. Traefik configured per design
  3. DNS entry pointing your NextCloud url ( to your keepalived IP


Setup data locations

Create the location for the bind-mount of the application data, so that it's persistent:

mkdir -p /var/data/kanboard

Setup Environment

If you intend to use an OAuth proxy to further secure public access to your instance, create a kanboard.env file to hold your environment variables, and populate with your OAuth provider's details (the cookie secret you can just make up):

# If you decide to protect kanboard with an oauth_proxy, complete these

Setup Docker Swarm

Create a docker swarm config file in docker-compose syntax (v3), something like this:


I share (with my sponsors) a private "premix" git repository, which includes necessary docker-compose and env files for all published recipes. This means that sponsors can launch any recipe with just a git pull and a docker stack deploy πŸ‘

version: '3'

    image: kanboard/kanboard
     - /var/data/kanboard/data:/var/www/app/data
     - /var/data/kanboard/plugins:/var/www/app/plugins
    - internal
        - traefik.port=80

      image: a5huynh/oauth2_proxy
      env_file : /var/data/config/kanboard/kanboard.env
        - internal
        - traefik_public
          - traefik.port=4180
        - /var/data/config/kanboard/authenticated-emails.txt:/authenticated-emails.txt
      command: |

    external: true
    driver: overlay
        - subnet:    


Launch Kanboard stack

Launch the Kanboard stack by running docker stack deploy kanboard -c <path -to-docker-compose.yml>

Log into your new instance at https://YOUR-FQDN. Default credentials are admin/admin, after which you can change (under 'profile') and add more users.

Chef's Notes πŸ““

  1. The default theme can be significantly improved by applying the ThemePlus plugin.
  2. Kanboard becomes more useful when you integrate in/outbound email with MailGun, SendGrid, or Postmark.

Tip your waiter (sponsor me) πŸ‘

Did you receive excellent service? Want to make your waiter happy? (..and support development of current and future recipes!) Sponsor me on Github / Patreon, or see the support page for more (free or paid) ways to say thank you! πŸ‘

Flirt with waiter (subscribe) πŸ’Œ

Want to know now when this recipe gets updated, or when future recipes are added? Subscribe to the RSS feed, or leave your email address below, and we'll keep you updated. (*double-opt-in, no monkey business, no spam)

Notify me πŸ””

Be the first to know when recipes are added / improved!

    We won't send you spam. Unsubscribe at any time. No monkey-business.

    Powered By ConvertKit

    Your comments? πŸ’¬

    Last update: June 8, 2020