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 admin@example.com
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): hitjethva@gmail.com - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 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:
Provide your SMTP details or click on the Skip this step button. You should see the following screen:
Provide your sitename, email, password and click on the Signup button. You will be redirected to the Orangescrum dashboard in the following page:
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.