In many organizations and working groups, a key word is required: organization. This is the key to start any project. Whether it is the development of a new application or the achievement of a goal. For this, different methodologies have been used and open source technology also has its contribution. Therefore, in this post, you will learn how to install Kanboard on Ubuntu 20.04.
In a few words, Kanboard is a free and open-source Kanban project management software.
This is a web-based application with which you can plan together with a team, the project to develop. Some of the things you can do with this application are the following:
- Visualize your work.
- Limit your work in progress to focus on your goal.
- Drag and drop tasks to manage your project.
- Self-hosted.
- Super simple installation.
The application is quite flexible and allows the use of plugins. With these, you will be able to extend Kanboard’s wide functionality.
So, let us begin.
Install Kanboard on Ubuntu 20.04
1.- Install LAMP on Ubuntu 20.04
Kanboard, being a web application, requires a server to process the application along with a language and a database. Fortunately, Kanboard supports several database managers such as MariaDB, SQLite or PostgreSQL, and several servers. In this post, we will use Apache and MariaDB, so we have to install the LAMP stack.
How to install LAMP on Ubuntu 20.04?
Once it is installed, install other modules and additional packages needed to enhance the installation:
php libapache2-mod-php php-curl php-json php-gd php-mysql php-intl php-xmlrpc php-zip php-sqlite3 php-dompdf php-xml php-mbstring curl git unzip
Then we can continue with the installation.
2.- Create a new Database for Kanboard
The next step is to create a new database and user for Kanboard to use. This step is recommended to avoid that the application works with the root user.
So, open the MariaDB shell
sudo mysql -u root -p
And now proceed to create the database, the user, and assign the corresponding permissions.
CREATE DATABASE kanboard; GRANT ALL PRIVILEGES ON kanboard.* TO 'kanboarduser'@'localhost' IDENTIFIED BY 'kanboardpss'; FLUSH PRIVILEGES; exit;
Feel free to change the values to whatever you prefer, especially the password, which needs to be quite strong.
3.- Download Kanboard
Now we can download Kanboard to our server. In this post, we will use the latest stable version and not the development one.
So, place it in the temporary folder.
cd /tmp
And with the help of the wget command, download Kanboard.
wget -c https://github.com/kanboard/kanboard/archive/v1.2.18.zip
After that, unzip the archive into the Apache directory with the unzip
command.
sudo unzip v1.2.18.zip -d /var/www/html/
The name of the generated folder is a bit confusing, so we’ll rename it to something simpler and easier to remember
sudo mv /var/www/html/kanboard-1.2.18/ /var/www/html/kanboard
Next, make Apache the owner of the folder where Kanboard is located.
sudo chown -R www-data:www-data /var/www/html/kanboard/
And assign the correct permissions to the folder:
sudo chmod -R 755 /var/www/html/kanboard/
Configuring Kanboard
Before using Kanboard, you need to set the database values in the configuration file.
So, use nano for this.
sudo nano /var/www/html/kanboard/config.default.php
And inside the file, modify the following values:
define('DB_DRIVER', 'mysql'); define('DB_USERNAME', 'kanboarduser'); define('DB_PASSWORD', 'kanboardpss'); define('DB_NAME', 'kanboard');
Remember that you have to modify the values you defined in the database. Then save the changes and close the editor.
Now, create a new VirtualHost for Kanboard:
sudo nano /etc/apache2/sites-available/kanboard.conf
With the following values:
<VirtualHost: *:80> ServerAdmin [email protected] DocumentRoot /var/www/html/kanboard/kanboard-1.2.18/ ServerName kanboard.osradar.test<Directory /var/www/kanboard/>
Options FollowSymlinks
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
Don’t forget, replace the ServerName
value with your domain.
Save the changes and close the editor.
Now, if Kanboard will be available on the web (most likely it will) then you have to create a security certificate and add it, this will enable secure connections over HTTPS.
So, install Certbot and the Apache plugin.
sudo apt install certbot python3-certbot-apache
Then, generate and add the certificate by running:
sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d [domain]
Replace the email
and domain
values with your own.
Then, enable the new VirtualHost, the rewrite module and apply the changes:
sudo a2ensite kanboard.conf sudo a2enmod rewrite sudo systemctl restart apache2
Now access from a web browser to your domain.
Testing Kanboard on Ubuntu 20.04
Now we can start the Kanboard test. To do this, open a web browser from your client computer and go to https://your-domain
and you will see the following screen:
Now use the default credentials which are admin/admin and then, you will see the Kanboard main screen.
You are now ready to go. Of course, it is recommended to change your password.
So, enjoy it.
Conclusion
The organization is the success of a project. And there is an open-source application that helps us to work in an organized team. This is the case of Kanboard. In this post, you have noticed how its installation in a Ubuntu 20.04 server.
So please, if you can, share this post with all your friends.