How to Install OrangeScrum on Ubuntu 16.04

r00t February 15, 2018

Install OrangeScrum on Ubuntu 16.04

In this tutorial we’ll learn how to install OrangeScrum on Ubuntu 16.04. We will also install and configure its prerequisites. OrangeScrum is a free and open source project management tool written using CakePHP which widely used in medium and small business. You can manage your projects, teams, documents and tasks all in one place using OrangeScrum. It is an awesome project management tool with simple and intuitive interface. Its features include collaboration, agile project management, issue tracking, notifications, task management, reporting and traditional project management functionality for small/medium businesses.

I recommend to use a minimal Ubuntu server setup as a basis for the tutorial, that can be a virtual or a root server image with an Ubuntu 16.04 minimal install from a web hosting company or you use our minimal server tutorial to install a server from scratch.

Install OrangeScrum on Ubuntu 16.04

Step 1. First, ensure your system and apt package lists are fully up-to-date by running the following:

apt-get update -y
apt-get upgrade -y

Step 2. Installing LAMP on Ubuntu 16.04.

You should check out this LAMP stack install tutorial for Ubuntu 16.04, if you haven’t installed LAMP yet. Once it’s installed, come back here and read on. We also will install the required packages for LAMP stack and the important PHP extension that OrangeScrum relies on:

apt-get install php7.0-mysql php7.0-curl php7.0-json php7.0-cgi php7.0 libapache2-mod-php7.0 php7.0-mcrypt php7.0-gd php7.0-mbstring php7.0-zip php7.0-dom php7.0-xml

Step 3. Installing OrangeScrum.

First, download OrangeScrum from the official web site. The latest stable release is 1.6.1 so you can download it with the following command:

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

Now just set the right permissions for the folders:

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

Step 4. Create a database for OrangeScrum.

Next, we need to create a database for the OrangeScrum installation:

mysql -uroot -p

Run the following command to create a database for OrangeScrum:

MariaDB [(none)]> CREATE DATABASE orangescrum;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON orangescrum.* TO 'orangescrumuser'@'localhost' IDENTIFIED BY 'PASSWORD';
MariaDB [(none)]> \q

Step 4. Setup a database for OrangeScrum.

Import the OrangeScrum data into the orangescrum database using following command as shown below:

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

Modify OrangeScrum configuration files:

### nano app/Config/database.php
public $default = array(
'datasource' => 'Database/Mysql',
'persistent' => false,
'host' => 'localhost',
'login' => 'orangescrumuser',
'password' => 'PASSWORD',
'database' => 'orangescrum',
'prefix' => '',
'encoding' => 'utf8',

Next, edit the ‘constants.php’ file and update the WEB_DOMAIN, FROM_EMAIL_NOTIFY and SUPPORT_EMAIL fields:

### nano app/Config/constants.php

define("WEB_DOMAIN", ""); //ex.
define('SUPPORT_EMAIL', ''); //(REQUIRED) From Email

Step 5. Configure Apache web server for OrangeScrum.

For this you can take the default config as a template:

cp /etc/apache2/sites-available/000-default.conf /etc/apache2/sites-available/orangescrum.conf

Now edit the currently created Config as follows:

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

Modify the virtual host file for your OrangeScrum site to resemble the example below:

<VirtualHost my-domain.tld:80>

ServerName my-domain.tld
ServerAdmin webmaster@localhost
DocumentRoot /var/www/html/orangescrum/

<Directory /var/www/html/orangescrum/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All

ErrorLog ${APACHE_LOG_DIR}/error-orangescrum.log
CustomLog ${APACHE_LOG_DIR}/access-orangescrum.log combined

Now just activate the newly created Config, mod_rewrite and SSL:

sudo a2ensite orangescrum.conf && sudo a2enmod SSL && sudo a2enmod rewrite

Finally, reload the web server as suggested, for the changes to take effect:

systemctl restart apache2

Step 6. Accessing OrangeScrum.

You can now complete the installation with the OrangeScrum web interface. Open your web browser and navigate to or http://{your-server-ip} to launch the installer.

Congratulation’s! You have successfully install and configured OrangeScrum on your Ubuntu 16.04 LTS server. Thanks for using this tutorial for installing OrangeScrum content management on Ubuntu 16.04 LTS (Xenial Xerus) system.

The Tags:

Leave a Comment

Comments are closed.