How To Install Wekan on Ubuntu 18.04 LTS

Install Wekan on Ubuntu 18.04

In this tutorial we will show you how to install Wekan on Ubuntu 18.04 LTS.  For those of you who didn’t know, Wekan is an open-source and collaborative kanban board application. With Wekan, we can create boards and cards which can be moved between a number of columns. Wekan allows you to invite members to the board and assign tasks to a specific member. This allows members of a team to collaborate more openly and know how the workload is being spread out across the team members.

This article assumes you have at least basic knowledge of Linux, know how to use the shell, and most importantly, you host your site on your own VPS. The installation is quite simple and assumes you are running in the root account, if not you may need to add ‘sudo’ to the commands to get root privileges. I will show you through the step by step installation Wekan on Ubuntu 18.04 server.

Install Wekan on Ubuntu 18.04 LTS Bionic Beaver

Step 1. First, make sure that all your system packages are up-to-date by running these following apt commands in the terminal.

Step 2. Installing Node.js.

Before installing nodejs, we will add a new system user ‘ramona’. We need to install nodejs because Wekan is a nodejs based application:

Now, log in as the ‘ramona’ user and install nodejs:

Next, we will install nvm as the wekan user, after which we will add a new configuration in the .bashrc configuration file:

We will test the nvm installation using the following commands:

To install nodejs we will using the commands:

Step 3. Installing MongoDB.

A stable version of MongoDB packages are already in the default Ubuntu repository. However, the version in Ubuntu’s repository isn’t the latest. If you want to install the latest version you must add a third-party repository to your system and install it from there:

After adding the repository key to Ubuntu, run the commands below to add MongoDB repository to your system:

After that, update your system and refresh existing repositories by running the commands below:

And now install the latest stable version of MongoDB:

MongoDB installation has been completed. We will start the MongoDB service and enable it:

We need to configure the MongoDB authentication. We will log in to the mongo shell and create a new ‘admin’ superuser:

Next, we run the Mongo query below to create a new admin user with password and set the role as root:

Then, we will enable the authentication by editing the MongoDB configuration file:

Find the ‘security’ line and edit the configuration:

Now, we can restart MongoDB so that the changes take place:

Login to the mongo shell as the admin user:

Run the following queries:

Step 4. Installing Wekan on Ubuntu 18.04.

First, download the latest version wekan source code using the wget command:

We will go to that directory and install the Wekan dependencies using the npm command:

Now, we will run the following commands to create the environment variables for Wekan application:

We will go to the ‘bundle’ directory and run the Wekan Node.js application:

Step 5. Configure Wekan SystemD Service.

We are already logged in as a wekan user and now we need to create a new environment variable file ‘.env’:

Then, edit and paste the following information:

Now, we will create a service file wekan.service:

Add the following content:

Start the Wekan service and enable it:

Step 6. Accessing Wekan.

Elkarte Community Forum will be available on HTTP port 80 by default. Open your favorite browser and navigate to http://your_ip_address:8000 and complete the required the steps to finish the installation. If you are using a firewall, please open port 8080 to enable access to the control panel.

Congratulation’s! You have successfully installed Wekan. Thanks for using this tutorial for installing Wekan open source kanban on your Ubuntu 18.04 system. For additional help or useful information, we recommend you to check the official Wekan website.

VPS Manage Service Offer
If you don’t have time to do all of this stuff, or if this is not your area of expertise, we offer a service to do “VPS Manage Service Offer”, starting from $10 (Paypal payment). Please contact us to get a best deal!