25.8 C
Senior Writer and partner

Install Leantime on Ubuntu 20.04

Hello, friends. Project management is something that we have to take into account in our organization or workgroup. So, in this post, you will learn how to install Leantime on Ubuntu 20.04.

Introducing to Leantime

Leantime is a straightforward open-source project management system to make your ideas reality

It is that kind of web application that allows us to manage our projects quickly and easily. For example, with Leantime you can plan your long-term roadmap and break down milestones into clear tasks that you can assign to your team members.

One of the best things about this application is that it requires little resources as it is a web application created with PHP. For this very reason, Leantime can be installed on many different operating systems which allows for a lot of choices.

- Advertisement -

So, in this post, you will learn how to install it step by step.

Install Leantime on Ubuntu 20.04

So, connect via SSH to your server and upgrade it.

sudo apt update
sudo apt upgrade

After this, then we can start the installation itself.

Install LAMP on Ubuntu 20.04

Since this is a web application, we can then use LAMP. So if you want to install it, then our post will help you with that.

Also, you have to install these PHP modules as well as other necessary packages.

php php-mysql php-curl php-curl php-curl php-json php-cgi php-xmlrpc php-gd php-mbstring unzip

Once you have them installed, then we can continue.

Create a new database on MariaDB

Leantime requires a database handler to store the generated data. So, we already have MariaDB installed, but it is convenient to create a new database as well as a dedicated user for Leantime.

So, open the MariaDB shell

sudo mysql -u root -p

Then, create the database, the user, and his permissions

GRANT ALL PRIVILEGES ON leantime.* TO 'user'@'localhost' IDENTIFIED BY 'password';

You can change the database name, user, and password to whatever you want.

Then exit the shell.


Download Leantime

Now you can download Leantime. To do this, we will use the wget command

cd /tmp/
wget https://leantime.io/download?wpdmdl=7413 -O leantime.zip
--2021-08-07 17:16:57--  https://leantime.io/download?wpdmdl=7413
Resolving leantime.io (leantime.io)...
Connecting to leantime.io (leantime.io)||:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 29635461 (28M) [application/zip]
Saving to: ‘leantime.zip’

leantime.zip                              100%[=====================================================================================>]  28.26M  4.17MB/s    in 7.1s

2021-08-07 17:17:05 (3.99 MB/s) - ‘leantime.zip’ saved [29635461/29635461]

Then, unzip it in the Apache root directory.

sudo unzip leantime.zip -d /var/www/html/leantime

So, make Apache the owner of the folder.

sudo chown -R www-data:www-data /var/www/html/leantime

And assign appropriate permissions to it:

sudo chmod -R 755 /var/www/html/leantime

The next step is to enable the default Leantime configuration. To do this, just rename the sample file.

sudo mv /var/www/html/leantime/config/configuration.sample.php /var/www/html/leantime/config/configuration.php

Edit the configuration file to set our database parameters.

sudo nano /var/www/html/leantime/config/configuration.php

And set the database name, user, and password.

/* Database */
public $dbHost="localhost"; //Database host
public $dbUser="user"; //Database username
public $dbPassword="password"; //Database password
public $dbDatabase="leantime"; //Database name
1.- Configuring the Leantime database
1.- Configuring the Leantime database

Next, you have to create a new Virtualhost for Leantime.

sudo nano /etc/apache2/sites-available/leantime.conf

Add the following

<VirtualHost *:80>
    ServerAdmin [email protected]
    DocumentRoot /var/www/html/leantime/
    ServerName leantime.osradar.test

    <Directory /var/www/html/leantime/>
        Options FollowSymLinks
        AllowOverride All
        Order allow,deny
        allow from all

    ErrorLog /var/log/apache2/leantime.osradar.test-error_log
    CustomLog /var/log/apache2/leantime.osradar.test-access_log common
2.- Creating a new Virtualhost for Leantime
2.- Creating a new Virtualhost for Leantime

Remember to change the value of ServerName to your server and ServerAdmin as well as anything else you see fit.Save the changes and close the editor.

So, enable the new Virtualhost.

sudo a2ensite leantime

And the rewrite Apache module and to apply the changes, restart Apache.

sudo a2enmod rewrite
sudo systemctl restart apache2

Enabling HTTPS with Let’s Encrypt

This step, although optional, is recommended because it guarantees that all the information that circulates is secure.

So, install Certbot and its Apache plugin.

sudo apt install certbot python3-certbot-apache

And now generate the certificate as follows

sudo certbot --apache --d [your-domain]

This way, after accepting the license terms and adding your email address, the certificates will be generated and installed.

You can restart Apache.

sudo systemctl restart apache

Now, to finish the job

Complete the installation

Now open your favorite web browser and go to https://your-domain/install where you will see the screen to create the new user.

3.- Leantime install screen
3.- Leantime install screen

After creating it, you will be informed that the process has been successful and you can log in.

4.- Leantime installed
4.- Leantime installed

Once logged in, you will be able to enjoy a tour of the application.

5.- Welcome to Leantime screen
5.- Welcome to Leantime screen

and then you will see the dashboard.

6.- Leantime dashaboard
6.- Leantime dashaboard

So, enjoy it-


In this post, you have learned how to install Leantime on Ubuntu 20.04. This application will help your team to manage the projects you need.

- Advertisement -
Everything Linux, A.I, IT News, DataOps, Open Source and more delivered right to you.
"The best Linux newsletter on the web"


Please enter your comment!
Please enter your name here

Latest article