How to Create a Minimalist Kanban in Linux with Kanboard

Kanboard is a lightweight kanban project tracker that you can host on your own server. Unlike other kanban trackers, it aims to create a simple and intuitive interface that you can access from anywhere.

This article will show you how you can install Kanboard in Ubuntu 22.04. It will also highlight the process of extending Kanboard using community plugins.

Why Use Kanboard?

One of the biggest advantages of Kanboard is that it can work on almost any server through the magic of Docker. As a result, hosting Kanboard is both painless and easy even for non-technical users.

Aside from that, Kanboard also comes with a flexible plugins platform. This includes the ability to create tags, track time and run custom scripts. For example, you can create a plugin that updates the properties of each card depending on its content.

Tip: Learn how to be efficient and effective at prioritizing tasks by understanding the Eisenhower Matrix.

Installing Kanboard

1. The first step in installing Kanboard is to make sure that your system is up to date. You can do this by running the following command:

sudo apt update
sudo apt upgrade

2. Install the Docker project’s third-party repository key:

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg
sudo chmod a+r /etc/apt/trusted.gpg.d/docker.gpg

3. Create a new apt repository file using your favorite text editor:

sudo nano /etc/apt/sources.list.d/docker.list

4. Write the repository information for the official Docker repository:

deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/docker.gpg] https://download.docker.com/linux/ubuntu jammy stable

5. Save your new repository file by pressing Ctrl + O, then Ctrl + X.

6. Update your system’s repository details by running the following command:

sudo apt update

7. Install Docker engine along with its dependencies using apt:

sudo apt install wget docker-ce docker-ce-cli containerd.io docker-compose-plugin docker-buildx-plugin

Obtaining Kanboard

Once you have Docker engine properly installed, the next thing to do is to fetch the Docker Compose script for Kanboard. This is a small text file that contains a list of options that will tell Docker how to automatically create Kanboard.

1. Create a separate folder in your home directory for Kanboard:

mkdir ~/kanboard
cd ~/kanboard

2. Create a new text file with the name “docker-compose.yml” through your favorite text editor:

nano ~/kanboard/docker-compose.yml

3. Copy the following block of code and paste it inside your “docker-compose.yml” file:

version: '2'
services:
  kanboard:
    image: kanboard/kanboard:latest
    ports:
      - 8080:80
    volumes:
      - kanboard_data:/var/www/app/data
      - kanboard_plugins:/var/www/app/plugins
    environment:
      DATABASE_URL: mysql://kanboard:!#REPLACE-ME@db/kanboard
      PLUGIN_INSTALLER: true
  db:
    image: mariadb:latest
    command: --default-authentication-plugin=mysql_native_password
    environment:
      MYSQL_ROOT_PASSWORD: !#REPLACE-ME
      MYSQL_DATABASE: kanboard
      MYSQL_USER: kanboard
      MYSQL_PASSWORD: !#REPLACE-ME
    volumes:
    - db:/var/lib/mysql
volumes:
  kanboard_data:
  kanboard_plugins:
  db:

4. Open a new terminal and generate a secure password using the following command:

cat /dev/urandom | tr -dc 'A-Za-z0-9' | fold -w 16 | head -n 1

5. Go back to your previous terminal and paste your secure password to every instance of “#!REPLACE-ME” inside the file.

6. Save and exit your “docker-compose.yml” file by pressing Ctrl + O, then Ctrl + X.

7. You can now build your Kanboard docker container by running the following command:

docker compose up -d

Good to know: Learn how you can create an offline Kanban board using Obsidian.md today.

Setting Up Kanboard for SSL

At this point, you now have a partially working Kanboard installation. However, in order to access it securely, you need to first create an Nginx reverse proxy. This will serve as your web-facing server that provides load balancing and SSL.

3. Install the Nginx webserver:

sudo apt install nginx

4. Create a site configuration file for your Nginx reverse proxy:

sudo nano /etc/nginx/sites-available/kanboard

5. Copy and paste the following block of code inside your new site configuration file:

server {
    listen 80;
    listen [::]:80;
 
    root                    /var/www/html;
    server_name             my-kanban-domain-url.com;
 
    location / {
        proxy_set_header    X-Forwarded-For $remote_addr;
        proxy_set_header    Host $http_host;
        proxy_pass          http://localhost:8080;
    }
}

Note: replace “my-kanban-domain-url.com” with the actual domain name.

6. Create a symbolic link for your Kanboard reverse proxy:

sudo ln -s /etc/nginx/sites-available/kanboard /etc/nginx/sites-enabled/kanboard

7. Reload your Nginx service daemon:

sudo systemctl reload nginx.service

Obtaining an SSL Certificate for Kanboard

With your reverse proxy up, you can now request an SSL certificate for your Kanboard. This section shows you how to obtain a free certificate through the Electronic Frontier Foundation’s (EFF) Certbot.

1. To begin, you need to install and update your system’s core snap daemon:

sudo snap install core
sudo snap refresh core

2. Install the certbot snap package:

sudo snap install --classic certbot

3. Create a symbolic link between the certbot snap binary and your system’s default binary directory:

sudo ln -s /snap/bin/certbot /usr/bin/certbot

4. Test if certbot is running by using it to register itself to the EFF:

sudo certbot register --agree-tos --email ramces@email.invalid

5. Generate an SSL certificate for your domain name by running the following command:

sudo certbot

Choose the domain from the entry and it will do its job to generate SSL for your domain.

Good to know: Learn more about encryption over the internet by creating your own self-signed SSL certificate.

Logging In and Creating A Kanban Board

You can now use Kanboard for creating and managing Kanban boards. To do that, login to your Kanboard instance by accessing its domain name from a web browser.

1. Use “admin” as the username and password in the login screen.
2. Click “New project” to create a public Kanban board.

3. Provide a name and URL slug for your new board.
4. Click “Public Access” on the page’s left sidebar.

5. Click the blue “Enable Public Access” button. This will create an RSS feed and a publicly viewable link that you can share with non-Kanboard users.

6. Click the “Board” button on the page’s upper left corner to access and create new items in your board.

Creating a User for Collaborative Kanban Boards

Aside from sharing publicly accessible “view-only” boards, you can also use Kanboard to create collaborative “task” boards between multiple local users.

1. Click the Admin user’s icon on the page’s upper right corner, then select “User management.”

2. Click the “New User” link along the page’s upper left sidebar.
3. This will bring up a small dialog prompt where Kanboard will ask you for the username and password of your new user.

4. Scroll down to the bottom of the prompt and click the drop-down box under the “Projects” category.

5. Select the Kanban board that you want the user to be a part of.

6. Click “Save” to create your new user account.

Customizing Your Kanban Board with Plugins

One of the brilliant features of Kanboard is that it provides a framework to extend your board beyond its basic features. This means that you do not need to rely on the developers to include a custom feature for your server.

1. To add a new plugin, click the Admin user’s icon on the page’s upper right corner, then select “Plugins.”

2. Click the “Plugin Directory” category on the page’s left sidebar.

3. Find a plugin that you want to install in your Kanboard server. In my case, I will install “MarkdownPlus” to extend the basic Markdown in my server.

4. Click “Install”, then refresh the webpage to properly load the plugin in your server.

FYI: Kanban is not the only way to manage tasks and data. Learn how you can optimize your To Do lists and data using Todoist today.

Frequently Asked Questions

Image credit: Eden Constantino via Unsplash. All alterations and screenshots by Ramces Red.

Ramces Red

Ramces is a technology writer that lived with computers all his life. A prolific reader and a student of Anthropology, he is an eccentric character that writes articles about Linux and anything *nix.