Installing OrangeScrum on CentOS 7
Prerequisites
- A VPS running CentOS with at least 2 GB of RAM. (Buy an international VPS)
- A user with sudo privileges.
Step 1: Update the operating system
Sign in as your sudo user and run the following commands to update the system:
sudo yum install epel-release -y
sudo yum update -y
sudo shutdown -r now
Once the server restarts, sign in again as your sudo user.
Step 2: Install and configure Apache
Install Apache with yum:
sudo yum install httpd -y
Disable Apache’s default welcome page:
sudo sed -i 's/^/#&/g' /etc/httpd/conf.d/welcome.conf
Stop Apache from listing files and directories in visitors’ browsers:
sudo sed -i "s/Options Indexes FollowSymLinks/Options FollowSymLinks/" /etc/httpd/conf/httpd.conf
Start the Apache service and enable it at boot:
sudo systemctl start httpd.service
sudo systemctl enable httpd.service
Step 3: Install and configure MariaDB
OrangeScrum needs MySQL 5.5, which you can install as MariaDB from the built-in yum repositories:
sudo yum install mariadb mariadb-server -y
Edit the MariaDB configuration:
sudo vi /etc/my.cnf
Add these lines to the [mysqld] section to set the character set and collation:
[mysqld]
datadir=/var/lib/mysql
socket=/var/lib/mysql/mysql.sock
init_connect='SET collation_connection=utf8_unicode_ci'
init_connect='SET NAMES utf8'
character-set-server=utf8
collation-server=utf8_unicode_ci
skip-character-set-client-handshake
Save and exit:
:wq!
Start the MariaDB service:
sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service
Secure the MariaDB installation:
sudo /usr/bin/mysql_secure_installation
Answer the interactive prompts as follows:
Enter current password for root (enter for none): Enter
Set root password? [Y/n]: Y
New password: <your-password>
Re-enter new password: <your-password>
Remove anonymous users? [Y/n]: Y
Disallow root login remotely? [Y/n]: Y
Remove test database and access to it? [Y/n]: Y
Reload privilege tables now? [Y/n]: Y
Step 4: Install and configure PHP
Add the IUS repository:
cd
wget https://centos7.iuscommunity.org/ius-release.rpm
sudo rpm -Uvh ius-release.rpm
Install PHP 5.6 and the required extensions from the IUS repository:
sudo yum install php56u php56u-mysqlnd php56u-gd php56u-imap php56u-ldap php56u-odbc php56u-xml php56u-xmlrpc php56u-mbstring php56u-mcrypt php56u-mssql php56u-snmp php56u-soap php56u-tidy php56u-pear curl libcurl-devel -y
Raise the upload size limit to 200 MB, as OrangeScrum needs:
sudo cp /etc/php.ini /etc/php.ini.bak
sudo sed -i "s/post_max_size = 8M/post_max_size = 200M/" /etc/php.ini
sudo sed -i "s/upload_max_filesize = 2M/upload_max_filesize = 200M/" /etc/php.ini
Restart Apache to load the new components:
sudo systemctl restart httpd.service
Step 5: Install OrangeScrum
1. Download OrangeScrum
cd
wget https://github.com/Orangescrum/orangescrum/archive/v1.6.1.tar.gz
tar -zxvf v1.6.1.tar.gz
2. Move the OrangeScrum files to the web root, /var/www/html, and set the right permissions:
sudo mv ~/orangescrum-1.6.1 /var/www/html && sudo chown root:root -R /var/www/html
sudo chmod -R 0777 /var/www/html/orangescrum-1.6.1/{app/Config,app/tmp,app/webroot}
3. Set up a virtual host for OrangeScrum
sudo vi /etc/httpd/conf.d/orangescrum.conf
Add the following:
<VirtualHost *:80>
ServerName orangescrum.example.com
DocumentRoot /var/www/html/orangescrum-1.6.1
<Directory /var/www/html/orangescrum-1.6.1>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>
</VirtualHost>
Save and exit with :wq!.
4. Create a database for OrangeScrum
Sign in to the MySQL shell as root, using the MariaDB root password you set earlier:
mysql -u root -p
In the MySQL shell, create a database named orangescrum and a user named orangescrumuser with your own password, then give that user all privileges on the database. Be sure to replace these values with your own:
CREATE DATABASE orangescrum;
CREATE USER 'orangescrumuser'@'localhost' IDENTIFIED BY 'yourpassword';
GRANT ALL PRIVILEGES ON orangescrum.* TO 'orangescrumuser'@'localhost' IDENTIFIED BY 'yourpassword' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;
Import the OrangeScrum data into the database:
mysql -u root -p orangescrum < /var/www/html/orangescrum-1.6.1/database.sql
5. Edit the OrangeScrum configuration files
To update the database credentials:
sudo vi /var/www/html/orangescrum-1.6.1/app/Config/database.php
Find these lines:
'login' => 'root',
'password' => '',
'database' => 'orangescrum',
Change them to:
'login' => 'orangescrumuser',
'password' => 'yourpassword',
'database' => 'orangescrum',
Save and exit with :wq!.
To update the email settings:
sudo vi /var/www/html/orangescrum-1.6.1/app/Config/constants.php
Find the following lines and replace the email addresses and password with your own:
define("SMTP_UNAME", "youremail@gmail.com");
define("SMTP_PWORD", "******");
define('FROM_EMAIL_NOTIFY', 'notify@mycompany.com');
define('SUPPORT_EMAIL', 'support@mycompany.com');
Save and exit with :wq!.
6. Restart Apache to apply your changes
sudo systemctl restart httpd.service
7. Open the firewall for web access
sudo firewall-cmd --zone=public --permanent --add-service=http
sudo firewall-cmd --reload
8. Point your web browser to http://your-server-IP and enter a company name, an email address and a password to sign in.
You’ve successfully installed OrangeScrum on CentOS.
Thanks for reading this guide from Mizbandade.

