How to Install OrangeScrum on CentOS 7

r00t February 14, 2018

Install OrangeScrum on CentOS 7

In this tutorial we’ll learn how to install OrangeScrum on CentOS 7. 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 CentOS server setup as a basis for the tutorial, that can be a virtual or a root server image with an CentOS 7 minimal install from a web hosting company or you use our minimal server tutorial to install a server from scratch.

Install OrangeScrum on CentOS 7

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

yum -y install epel-release
yum -y update

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:

wget https://github.com/Orangescrum/orangescrum/archive/v1.6.1.tar.gz
tar -zxvf v1.6.1.tar.gz
mv ~/orangescrum-1.6.1 /var/www/html

Now just set the right permissions for the folders:

chown apache:apache -R /var/www/html
chmod -R 0777 /var/www/html/orangescrum-1.6.1/{app/Config,app/tmp,app/webroot}

Step 4. Setup a database for OrangeScrum.

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

mysql -u root -p orangescrum < /var/www/html/orangescrum-1.6.1/database.sql

Modify OrangeScrum configuration files:

nano /var/www/html/orangescrum-1.6.1/app/Config/database.php

Find the following lines:

'login' => 'root',
'password' => '',
'database' => 'orangescrum',

Change them to:

'login' => 'orangescrumuser',
'password' => 'yourpassword',
'database' => 'orangescrum',

Step 5. Configure Apache web server for OrangeScrum.

Let’s configure an Apache virtual host. You can do this by creating /etc/httpd/conf.d/orangescrum.conf file:

sudo nano /etc/httpd/conf.d/orangescrum.conf

Add the following lines:

<VirtualHost *:80>
ServerAdmin admin@example.com
DocumentRoot /var/www/html/orangescrum-1.6.1
ServerName orangescrum.example.com
ServerAlias www.orangescrum.example.com
<Directory /var/www/html/orangescrum-1.6.1/>
Options FollowSymLinks
AllowOverride All
Order allow,deny
allow from all
</Directory>
ErrorLog /var/log/httpd/orangescrum.example.com-error_log
CustomLog /var/log/httpd/orangescrum.example.com-access_log common
</VirtualHost>

Save and close the file, then restart Apache service:

sudo systemctl restart httpd

We should allow HTTP traffic on port 80 through firewalld. You can do this by running the following command:

sudo firewall-cmd --zone=public --add-service=http --permanent
sudo firewall-cmd --reload

Step 6. Accessing OrangeScrum.

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

Congratulation’s! You have successfully install and configured OrangeScrum on your CentOS 7 server. Thanks for using this tutorial for installing OrangeScrum content management system on CentOS 7 system.

The Tags:

Leave a Comment

Comments are closed.