Atlantic.Net Blog

How to Install Kanboard on Ubuntu 20.04

Kanboard is a free and open-source project management software that helps you visualize and limit your work in progress to focus on your goal. It follows the Kanban methodology and is specially designed for those people who want to manage their projects efficiently and simply. Kanboard also provides support for reports and analytics and can be integrated with external services. It allows you to create multiple projects and customize your boards according to your needs.

In this tutorial, we will learn how to install the Kanboard software on Ubuntu 20.04.


  • A fresh Ubuntu 20.04 VPS on the Atlantic.Net Cloud Platform
  • A root password configured on your server

Step 1 – Create an Atlantic.Net Cloud Server

First, log in to your Atlantic.Net Cloud Server. Create a new server, choosing Ubuntu 20.04 as the operating system with at least 2GB RAM. Connect to your Cloud Server via SSH and log in using the credentials highlighted at the top of the page.

Once you are logged in to your Ubuntu 20.04 server, run the following command to update your base system with the latest available packages.

apt-get update -y

Step 2 – Install Apache, MariaDB, and PHP

First, you will need to install Apache web server, MariaDB, PHP and other necessary extensions in your system. You can install all of them with the following command:

apt-get install apache2 mariadb-server php libapache2-mod-php php-common php-curl php-intl 
php-mbstring php-xmlrpc php-mysql php-gd php-pgsql php-xml php-cli php-zip unzip wget curl git 

After installing all the packages, edit the php.ini file and make some desired changes:

nano /etc/php/7.4/apache2/php.ini

Change the following lines:

file_uploads = On
allow_url_fopen = On
short_open_tag = On
memory_limit = 512M
upload_max_filesize = 150M
max_execution_time = 360
date.timezone = America/Chicago

Save and close the file, then restart the Apache service to apply the changes:

systemctl restart apache2

Step 3 – Create a Database for Kanboard

Next, you will need to create a database and user for Kanboard. First, log into MariaDB with the following command:


Once logged in, create a database and user with the following command:

CREATE USER 'kanboard'@'localhost' IDENTIFIED BY 'password';

Next, grant all the privileges to the database with the following command:

GRANT ALL ON kanboard.* TO 'kanboard'@'localhost' WITH GRANT OPTION;

Next, flush the privileges and exit from the MariaDB with the following command:


At this point, your database and user are created. You can now proceed to the next step.

Step 4 – Download Kanboard

First, download the latest version of Kanboard from the Git repository using the following command:


Once downloaded, unzip the downloaded file with the following command:


Next, move the extracted directory to the Apache root directory:

mv kanboard-1.2.15 /var/www/html/kanboard

Next, change the directory to kanboard and rename the default configuration file:

cd /var/www/html/kanboard
cp config.default.php config.php

Next, edit the default configuration file with the following command:

nano config.php

Define your database setting as shown below, and ensure you overwrite the default entries already in confiig.php:

// Database driver: sqlite, mysql or postgres (sqlite by default)
define('DB_DRIVER', 'mysql');

// Mysql/Postgres username
define('DB_USERNAME', 'kanboard');

// Mysql/Postgres password
define('DB_PASSWORD', 'password');

// Mysql/Postgres hostname
define('DB_HOSTNAME', 'localhost');

// Mysql/Postgres database name
define('DB_NAME', 'kanboard');

Save and close the file, then give proper ownership and permissions to Kanboard:

chown -R www-data:www-data /var/www/html/kanboard
chmod -R 755 /var/www/html/kanboard

Step 5 – Configure Apache for Kanboard

First, create an Apache virtual host configuration file using the following command:

nano /etc/apache2/sites-available/kanboard.conf

Add the following lines:

<VirtualHost *:80>
ServerAdmin [email protected]
DocumentRoot /var/www/html/kanboard

<Directory /var/www/html/kanboard/>
Options FollowSymlinks
AllowOverride All
Require all granted
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined


Save and close the file, then activate the virtual host and enable the Apache rewrite module with the following command:

a2ensite kanboard.conf
a2enmod rewrite

Finally, restart the Apache service to apply the changes:

systemctl restart apache2

Step 6 – Access Kanboard UI

Now, open your web browser and access Kanboard using the URL You will be redirected to the Kanboard login page:

Provide default username and password as admin / admin and click on the Sign in button. You should see the Kanboard dashboard in the following page:


Congratulations! You have successfully installed Kanboard on Ubuntu 20.04 server. You can now create your own project, create board and start managing project work-flow using the Kanban methodology. Try Kanboard on VPS Hosting from Atlantic.Net using the tutorial above!

Get started with 12 months of free cloud VPS hosting

Free Tier includes:
G3.2GB Cloud VPS Server Free to Use for One Year
50 GB of Block Storage Free to Use for One Year
50 GB of Snapshots Free to Use for One Year