Knowledgebase

Kanboard is a free and open source project management software program which is designed to facilitate and visualize team workflow using the Kanban methodology.

In this article, I will show you how to setup Kanboard on CentOS 7.

Prerequisites

• A Rcs CentOS 7 server instance, say its IP is 203.0.113.1.
• A sudo user.

Step 1: Update the system

As usual, log into the server as a sudo user from an SSH terminal, and then update the CentOS 7 system to the latest stable status:

sudo yum install epel-release -y
sudo yum update -y
sudo shutdown -r now

After the reboot, log back in as the same sudo user and continue to the next step.

Step 2: Install Apache

Install the Apache 2.4 web server for Kanboard using YUM:

sudo yum install httpd -y

Remove the preset Apache welcome page:

sudo sed -i 's/^/#&/g' /etc/httpd/conf.d/welcome.conf

Prevent Apache from exposing files to visitors:

sudo sed -i "s/Options Indexes FollowSymLinks/Options FollowSymLinks/" /etc/httpd/conf/httpd.conf

Start the Apache service:

sudo systemctl start httpd.service
sudo systemctl enable httpd.service

Step 3: Install MariaDB 10.1

By default, Kanboard use SQLite to store its data. Alternatively, you can choose MariaDB 10 or greater to enhance performance in a production environment.

Copy the following code segment into your SSH terminal, then press Enter to import the repo file:

cat <<EOF | sudo tee -a /etc/yum.repos.d/MariaDB.repo
# MariaDB 10.1 CentOS repository list - created 2017-01-14 03:11 UTC
# http://downloads.mariadb.org/mariadb/repositories/
[mariadb]
name = MariaDB
baseurl = http://yum.mariadb.org/10.1/centos7-amd64
gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
gpgcheck=1
EOF

Install MariaDB 10.1 using YUM:

sudo yum install MariaDB-server MariaDB-client -y

Start the MariaDB service:

sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

Secure the installation of MariaDB:

sudo /usr/bin/mysql_secure_installation

Reply to the questions on the screen as shown below. For security purposes, you should always setup a private and strong MariaDB root password.

Enter current password for root (enter for none): Enter
Set root password? [Y/n]: Y
New password: <your-password>
Re-enter new password: <your-password>
Remove anonymous users? [Y/n]: Y
Disallow root login remotely? [Y/n]: Y
Remove test database and access to it? [Y/n]: Y
Reload privilege tables now? [Y/n]: Y

Step 4: Install PHP 7

Kanboard requires PHP 5.3.9 or greater. In order to get best performance, you can install PHP 7.1 and its necessary dependencies using the Webtatic YUM repo as follows:

sudo rpm -Uvh https://mirror.webtatic.com/yum/el7/webtatic-release.rpm
sudo yum install php71w php71w-mysqlnd php71w-gd php71w-mbstring php71w-common php71w-ldap php71w-opcache php71w-cli -y

Step 5: Install Kanboard

Download and install the latest release of Kanboard:

cd /var/www/html
sudo wget https://kanboard.net/kanboard-latest.zip
sudo yum install unzip -y
sudo unzip kanboard-latest.zip
sudo chown -R apache:apache kanboard/data
sudo rm kanboard-latest.zip

Setup a MySQL database and a database user for Kanboard:

mysql -u root -p -e "CREATE DATABASE kanboard;" 
mysql -u root -p kanboard < /var/www/html/kanboard/app/Schema/Sql/mysql.sql
mysql -u root -p -e "CREATE USER 'kanboarduser'@'localhost' IDENTIFIED BY 'yourpassword';"
mysql -u root -p -e "GRANT ALL PRIVILEGES ON kanboard.* TO 'kanboarduser'@'localhost' IDENTIFIED BY 'yourpassword' WITH GRANT OPTION;"
mysql -u root -p -e "FLUSH PRIVILEGES;"

Note:

1. When prompted, input the MariaDB root password you had setup earlier.
2. You should choose a strong user password other than the one listed above.

Update the Kanboard configuration file in order to switch to MySQL:

cd /var/www/html/kanboard
sudo mv config.default.php config.php
sudo vi config.php

Find the following lines:

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

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

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

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

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

Modify them in accordance with:

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

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

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

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

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

Restart Apache:

 sudo systemctl restart httpd.service

Allow visitors access Kanboard on port 80:

sudo firewall-cmd --zone=public --permanent --add-service=http
sudo firewall-cmd --reload

Finally, point your web browser to http://203.0.113.1/kanboard to start using Kanboard. Use the following default credentials to log in:

• Username: admin
• Password: admin

Note: For security purposes, remember to modify admin's password using the users management link from the upper right-hand admin drop-down menu.

Step 6 (Optional): Setup Zend OpCache

In order to achieve best performance on your Kanboard server, you can adjust the settings of Zend OpCache which has been enabled by default.

For example, when using Kanboard on a single-node setup in production as we intended in this article, you can use the following settings as a starter to optimize Zend OpCache.

Open the Zend OpCache configuration file:

sudo vi /etc/php.d/opcache.ini

Modify the file in accordance with the following settings:

zend_extension=opcache.so;
opcache.enable=1;
opcache.file_cache=/tmp/opcache
opcache.validate_timestamps=0
opcache.revalidate_freq=0
opcache.memory_consumption=192
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=1979
opcache.fast_shutdown=1

Save and quit:

:wq!

Restart the Apache service in order to put your changes into effect:

sudo systemctl restart httpd.service

Later, you can fine tune your settings by editing relevant lines in the /etc/php.d/opcache.ini file again.

Step 7 (Optional): Setup a daily cron job for reports and analytics

In order to generate accurate reports and analytics, you need to setup a daily cron job using the apache user:

sudo crontab -u apache -e

Populate the crontab file with:

0 3 * * * cd /var/www/html/kanboard && ./cli cronjob >/dev/null 2>&1

Save and quit:

:wq!

In this fashion, all of the reports and analytics will be updated at 3:00 AM everyday.

That concludes our tutorial. Thanks for reading.