How to Install and Configure OrangeScrum on Ubuntu 20.04

Orangescrum is a free and open-source project management and collaboration application. It is ideal for small and medium businesses and helps you to create and manage your projects, teams, documents, and tasks and communicate with the other team members. It is a very useful project management application with a simple interface that helps you to plan, organize, and manage your tasks for any projects. It comes with a lot of features including, Scrum Board, Sprint Planning and Reports, Story Points, Project Backlog, and many more.

In this tutorial, we will show you how to install OrangeScrum Project management tool on Ubuntu 20.04 server.

Prerequisites

  • A server running Ubuntu 20.04.
  • A valid domain name pointed with your server IP.
  • A root password is configured on the server.

Install Apache, MariaDB and PHP

First, install the Apache web server and MariaDB database server with the following command:

apt-get install apache2 mariadb-server -y

After installing the above packages, you will need to install PHP version 7.2 and other required extensions in your system. By default, Ubuntu 20.04 ships with the PHP version 7.4 so you will need to add the Ondrej repository in your system.

First, install the required packages with the following command:

apt-get install software-properties-common gnupg2 -y

Next, add the Ondrej repository with the following command:

add-apt-repository ppa:ondrej/php

Next, update the repository and install PHP along with other required packages with the following command:

apt-get install php7.2 php7.2-bcmath php7.2-cgi php7.2-cli php7.2-common php7.2-curl php7.2-dba php7.2-enchant php7.2-fpm php7.2-gd php7.2-imap php7.2-intl php7.2-ldap php7.2-mbstring php7.2-mysql php7.2-opcache php7.2-imagick php7.2-memcache php7.2-soap php7.2-tidy php7.2-xml php7.2-zip libapache2-mod-php7.2 xvfb libfontconfig wkhtmltopdf unzip wget -y

Once all the packages are installed, edit the php.ini file and change some required settings:

nano /etc/php/7.2/apache2/php.ini

Change the following values:

post_max_size = 200M
upload_max_filesize = 200M
max_execution_time = 300
memory_limit = 512M
max_input_vars = 5000
date.timezone = Asia/Kolkata

Save and close the file then restart the Apache service to apply the changes:

systemctl restart apache2

Once you are finished, you can proceed to the next step.

Create a Database for OrangeScrum

Next, you will need to create a database and user for OrangeScrum. First, log into the MariaDB shell with the following command:

mysql

Once login, create a database and user with the following command:

MariaDB [(none)]> CREATE DATABASE orangescrumdb;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON orangescrumdb.* TO 'orangescrumuser'@'localhost' IDENTIFIED BY 'password';

Next, flush the privileges and exit from the MariaDB shell with the following command:

MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> exit;

Next, you will need to disable strict mode for MariaDB. You can do this by creating disable_strict_mode.cnf file:

nano /etc/mysql/conf.d/disable_strict_mode.cnf

Add the following lines:

[mysqld]
sql_mode="IGNORE_SPACE,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION"

Save and close the file. Then, restart MariaDB to apply all the changes:

systemctl restart mariadb

Install OrangeScrum

First, you will need to download the latest version of OrangeScrum from their official website. After downloading it, unzip the downloaded file with the following command:

unzip orangescrum-master.zip

Next, move the extracted directory to the Apache root directory with the following command:

mv orangescrum-master /var/www/html/orangescrum

Next, change the directory to the Orangescrum and import the OrangeScrum database into your database:

cd /var/www/html/orangescrum
mysql -u orangescrumuser -p orangescrumdb < database.sql

Enter the password that you have chosen for the 'orangescrumuser' MySQL user when requested by the mysql command.

Next, edit the database.php file and define your database settings:

nano app/Config/database.php

Change the following lines:

class DATABASE_CONFIG {

        public $default = array(
                'datasource' => 'Database/Mysql',
                'persistent' => false,
                'host' => 'localhost',
                'login' => 'orangescrumuser',
                'password' => 'password',
                'database' => 'orangescrumdb',
                'prefix' => '',
                'encoding' => 'utf8',
        );
}

Save and close the file when you are finished.

Next, give proper permissions to the orangescrum directory:

chown -R www-data:www-data /var/www/html/orangescrum
chmod -R 775 /var/www/html/orangescrum

Configure Apache for OrangeScrum

Next, you will need to create a new Apache virtual host configuration file for OrangeScrum. You can create it with the following command:

nano /etc/apache2/sites-available/orangescrum.conf

Add the following lines:

<VirtualHost *:80>
        ServerAdmin [email protected]
        DocumentRoot /var/www/html/orangescrum/
        ServerName orangescrum.example.com
    <Directory /var/www/html/orangescrum/>
             DirectoryIndex index.php index.html
             AllowOverride All
             Allow from all
             Order allow,deny
             Options Indexes FollowSymlinks
    </Directory>
</VirtualHost>

Save and close the file then enable the Apache virtual host file with the following command:

a2ensite orangescrum.conf

Next, enable the required modules with the following command:

phpenmod mbstring
a2enmod rewrite
a2enmod headers

Next, restart the Apache service to apply the changes:

systemctl restart apache2

You can now verify the status of Apache with the following command:

systemctl status apache2

You should get the following output:

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2020-09-17 15:36:20 UTC; 5min ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 40670 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCESS)
   Main PID: 40689 (apache2)
      Tasks: 11 (limit: 2353)
     Memory: 47.1M
     CGroup: /system.slice/apache2.service
             ??40689 /usr/sbin/apache2 -k start
             ??40690 /usr/sbin/apache2 -k start
             ??40692 /usr/sbin/apache2 -k start
             ??40694 /usr/sbin/apache2 -k start
             ??40698 /usr/sbin/apache2 -k start
             ??40699 /usr/sbin/apache2 -k start
             ??40700 /usr/sbin/apache2 -k start
             ??40706 /usr/sbin/apache2 -k start
             ??40808 /usr/sbin/apache2 -k start
             ??40809 /usr/sbin/apache2 -k start
             ??40810 /usr/sbin/apache2 -k start

Sep 17 15:36:20 ubuntu2004 systemd[1]: Starting The Apache HTTP Server...

Secure OrangeScrum with Let's Encrypt SSL

Next, it is recommended to secure OrangeScrum with Let's Encrypt SSL. First, install the Certbot client to manage the SSL.

apt-get install python3-certbot-apache -y

After installing the Certbot client, run the following command to install the Let's Encrypt SSL for your domain:

certbot --apache -d orangescrum.example.com

You will be asked to provide your email and accept the term of service as shown below:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator apache, Installer apache
Enter email address (used for urgent renewal and security notices) (Enter 'c' to
cancel): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server at
https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)gree/(C)ancel: A

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing to share your email address with the Electronic Frontier
Foundation, a founding partner of the Let's Encrypt project and the non-profit
organization that develops Certbot? We'd like to send you email about our work
encrypting the web, EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y
Obtaining a new certificate
Performing the following challenges:
http-01 challenge for orangescrum.example.com
Enabled Apache rewrite module
Waiting for verification...
Cleaning up challenges
Created an SSL vhost at /etc/apache2/sites-available/orangescrum-le-ssl.conf
Enabled Apache socache_shmcb module
Enabled Apache ssl module
Deploying Certificate to VirtualHost /etc/apache2/sites-available/orangescrum-le-ssl.conf
Enabling available site: /etc/apache2/sites-available/orangescrum-le-ssl.conf

Next, choose whether or not to redirect HTTP traffic to HTTPS as shown below:

Please choose whether or not to redirect HTTP traffic to HTTPS, removing HTTP access.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: No redirect - Make no further changes to the webserver configuration.
2: Redirect - Make all requests redirect to secure HTTPS access. Choose this for
new sites, or if you're confident your site works on HTTPS. You can undo this
change by editing your web server's configuration.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2

Type 2 and hit Enter to continue. Once the installation has been finished, you should see the following output:

Enabled Apache rewrite module
Redirecting vhost in /etc/apache2/sites-enabled/orangescrum.conf to ssl vhost in /etc/apache2/sites-available/orangescrum-le-ssl.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Congratulations! You have successfully enabled https://orangescrum.example.com

You should test your configuration at:
https://www.ssllabs.com/ssltest/analyze.html?d=orangescrum.example.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/orangescrum.example.com/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/orangescrum.example.com/privkey.pem
   Your cert will expire on 2020-11-11. To obtain a new or tweaked
   version of this certificate in the future, simply run certbot again
   with the "certonly" option. To non-interactively renew *all* of
   your certificates, run "certbot renew"
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

Now, you can access your Open Classifieds website securely using the URL https://orangescrum.example.com.

Access OrangeScrum

Now, open your web browser and type the URL https://orangescrum.example.com. You should see the OrangeScrum Sign Up screen:

Configure Hostname, Username and Password

Provide your SMTP details or click on the Skip this step button. You should see the following screen:

Company setup

Provide your sitename, email, password and click on the Signup button. You will be redirected to the Orangescrum dashboard in the following page:

OrangeScrum Dashboard

Conclusion

Congratulations! you have successfully installed OrangeScrum with Let's Encrypt SSL on Ubuntu 20.04 server. You can now create your first project, invite users and create and assign a task for them. Feel free to ask me if you have any questions.

Share this page:

3 Comment(s)