Article

Table of Contents
Theme:
Was this article helpful?
Try Vultr Today with

$50 Free on Us!

Want to contribute?

You could earn up to $600 by adding new articles.

How to Install Kanboard on CentOS 7

Last Updated: Wed, Jan 25, 2017
CentOS Linux Guides Server Apps

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 Vultr 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.

Want to contribute?

You could earn up to $600 by adding new articles.