We will be glad to help you out. Get in touch with the creators of Orangescrum. We always welcome feedback as it helps us to bring out the best within us. We would like to hear your thoughts or you want to share an idea or simply say Hello!
Submit Your Testimonial
We want to hear from you! Submit your experience below and we will share it with others. Your Testimonial will get published on the front page of our website.
✕
Login
Get access to your Orders, Wishlist and Recommendations
✕
Signup
Get access to your Orders, Wishlist and Recommendations
✕
Reset Your Password
Get access to your Orders, Wishlist and Recommendations
✕
Want 25% off Your Order ?
Use coupon code
OSFLAT25
and enjoy sitewide saving off 25% just for shopping with us !
* Online Order Only. Can't be combining with other offer
✕
Oops!
Coupon Code cannot be applied for this discounted item.
Note: Please remove Combo-12 or Combo-13 from the cart and apply the coupon code for other add-on(s) in your cart. You can buy Combo-12 or Combo 13 Separately.
* Online Order Only. Can't be combining with other offer
✕
Wait, We Have a special offerEnter your Email and get 0% off Coupon!
Valid for 72 hrs
Orangescrum Installation Guide for Linux (CentOS, Ubuntu, Debian)
Automated Installation Script
The automated wizard does all the heavy lifting for you. Just a few clicks and you are on with your favorite project management software.
Manual Installation Script
For the tech genius inside you to get your hands dirty to set things up from the scratch. Follow the instructions to for the installation.
This page explains how to install Orangescrum community edition on your web server and start tracking time, your projects, tasks and resources.
Getting Started
Before you get started, ensure that you have the following:
A web server, shared hosting or dedicated server.
Access to your web server (via shell or FTP)
A FTP Client (if you are installing Orangescrum on a remote server)
If you do not have a web server or shared host to install Orangescrum on, you can install docker image or Amazon AMI in minutes.
Xampp for windows, mac to install Orangescrum on local server
Note: This script will not work on shared hosting, only works on Ubuntu-16 & Ubuntu-18, CentOS 7 and Debian 9 dedicated servers only.
Note: Sound knowledge of server operating system, database and PHP language is preferably required.
Check you meet the minimum requirements
Check below to make sure that your web host meets the minimum requirements to run Orangescrum.
To run Orangescrum your host needs a couple of things:
Web Server such as Apache 2.4, Nginx, etc.
PHP version 7.2
MySQL version 5.6 or 5.7
PHP extension Wkhtmltopdf (needed for PDF export), Imagemagick (for profile photo)
(enabled by default) PHP extension pdo and pdo_mysql, or the mysqli extension.
Recommended Servers sizing (CPU, RAM, Disks)
App server minimum recommended configuration
RAM: minimum 2 GB (for more than 1,000 tasks, RAM: 4GB)
Processor: Core2duo or Higher
OS: Ubuntu 16 or 18, CentOS 7 And Debian 9
Disk Space: 10 GB or Higher
Recommended Configuration
We recommend using the latest PHP 7.2 as it is more memory efficient and faster than previously recommended PHP 5.6 version.
We recommend using MySQL 5.7 for your database.
To make the most out of Orangescrum, you also need a few extra PHP extensions such as the Wkhtmltopdf (needed for PDF export), Imagemagick (for profile photo). The list of PHP extensions you are recommended to install are:
A Fresh Linux Server (Ubuntu 16 or 18, CentOS 7 and Debian 9)
Internet Connection
Email ID
Email Password
Email SMTP Mail Server Hostname / Private Mail Server Hostname (e.g., mail.gmail.com or smtp.yahoo.com, etc.)
SMTP Port (e.g., 25, 465, 587, etc.)
Note: If Gmail ID is used for SMTP configuration, make sure to enable the "less secure app" function. You can do this by logging into the gmail account and go to "My Accounts" then click on "Sign-in & Security" and enable the "Allow less secure apps: ON".
Note: Make sure to whitelist the application server Domain/IP address from the private Mail Server.
Note: Orangescrum will only work on MySQL 5.6 or 5.7, Apache 2.4 and PHP 7.2
If SELinux is installed and enabled, please set it to permissive mode For temporary "setenforce 0" For Permanent: edit the "config" file in "/etc/selinux/config" and set selinux=permissive
Download Orangescrum
Download the latest release Orangescrum v1.8.0 from here:
If you have a dedicated Linux (Ubuntu-16 & Ubuntu-18, CentOS 7 and Debian 9) server, you can run the automated script, otherwise follow the manual installation guide.
When you download the community edition for Linux OS, it downloads the automated script only. The script will install the following on your server when you run it in next step:
Installs required packages and dependencies to support the application
Installs and configure Apache Web Server
Installs MySQL Server, creates database and configures user for database or create database in an existing mysql setup and configures user, requires existing root password.
Setup cron jobs
Copy the zip file to the Server’s "/tmp" directory where the application will be installed. *You can use "Winscp" or "Filezilla" to upload the package to your Server.
Login to "root" or run "sudo su -", enter the root password:
The downloaded setup file is in zip format, to extract the file you need unzip command, If you don’t have unzip command follow the steps:
To install unzip: "yum install –y unzip",
To unzip Orangescrum PHP 7.2 setup script, use the following command:
tmp]# unzip os-php72-setup.zip
Give permission to the script file:
For Orangescrum PHP 7.2 script, use the following command:
tmp]# chmod +x os-php72-setup
Run the script file: For Orangescrum PHP 7.2 script, use the following command:
tmp]# ./os-php72-setup
During Installation if MySQL database is already installed, it will ask for root password for MySQL database, else it will ask to setup root password for new installation:
It will install all the required packages and dependencies and will ask for email ID, Database Name, Database User Name, Database Password and Domain name or IP address for the Host.
The database details you will enter on step 10 are displayed as shown below which you need during the Orangescrum Installation wizard.
Before installing for Ubuntu 16 or Ubuntu 18, make sure you follow the steps mentioned in "Start the Installation"
To unzip the download file, install unzip extension for Ubuntu: "apt-get -y install unzip",
To unzip Orangescrum PHP 7.2 setup script, use the following command:
tmp]# unzip os-php72-setup.zip
Give permission to the script file: For Orangescrum PHP 7.2 script, use the following command:
tmp]# chmod +x os-php72-setup
Run the script file: For Orangescrum PHP 7.2 script, use the following command:
tmp]# ./os-php72-setup
During Installation if MySQL database is already installed, it will ask for root password for MySQL database, else it will ask to setup root password for new installation:
Re-enter the password as per the above given screen-shot.
Please enter the password below which you have created in the above steps:
After installing MySQL database, follow the steps to setup the phpMyAdmin:
Select "apache2" and press "ok" to re-configure the Web Server automatically
Select "Yes" to re-configure the database for phpMyAdmin with dbconfig-common:
Enter MySQL application password for phpMyAdmin, Enter the Database password you have just created:
It will install all the required packages and dependencies and will ask for email ID, Database Name, Database User Name, Database Password and Domain name or IP address for the Host.
The database details you will enter on step 10 are displayed as shown below which you need during the Orangescrum Installation wizard.
Before installing for Debian 9, make sure you follow the steps mentioned in "Start the Installation"
To unzip the download file, install unzip extension for Ubuntu: "apt-get -y install unzip",
To unzip Orangescrum PHP 7.2 setup script, use the following command:
tmp]# unzip os-php72-setup.zip
Give permission to the script file: For Orangescrum PHP 7.2 script, use the following command:
tmp]# chmod +x os-php72-setup
Run the script file: For Orangescrum PHP 7.2 script, use the following command:
tmp]# ./os-php72-setup
During Installation if MySQL database is already installed, it will ask for root password for MySQL database, else it will ask to setup root password for new installation:
During Installation if MySQL database is already installed, it will ask for root password for MySQL database, else it will ask to setup root password for new installation:
Please enter the password below which you have created in the above steps:
After installing MySQL database for Debian 9, follow the steps to setup the phpMyAdmin:
Select "apache2" and press "ok" to re-configure the Web Server automatically
Select "Yes" to re-configure the database for phpMyAdmin with dbconfig-common:
Enter MySQL application password for phpMyAdmin, Enter the Database password you have just created:
Re-Confirm the database password:
Please provide the Administrative user's Password to create and modify database
It will install all the required packages and dependencies and will ask for email ID, Database Name, Database User Name, Database Password and Domain name or IP address for the Host.
The database details you will enter on step 10 are displayed as shown below which you need during the Orangescrum Installation wizard.
Open your browser and run Orangescrum the http://yoursiteurl.com/. If Orangescrum is hosted on a local network, then run http://localhost/orangescrum-master or run the IP/domain as configured.
If everything is configured correctly, you should see the Orangescrum Installation Wizard.
MySQL Database Setup
Once you hit the URL, you can see the Database Configuration Wizard
On the Database Configuration wizard, provide your Database Name, Database Host, Username, Password and click Next button.
Note: You should already have MySQL database password as you have provided in earlier step.
SMTP Configuration
SMTP configuration is needed for email notifications and email replies to post as comments. Without SMTP, you can add users in the latest release v1.8.0.
On the SMTP Configuration Wizard, configure the SMTP with Host Name, Port, Username and Password.
Note: You can Skip SMTP setup by clicking on "Skip". Also, this step doesn’t verify your SMTP configuration. Follow the SMTP troubleshooting to fix the SMTP/Email notification issue.
Congratulations!
Once you click on the "Finish" button, you'll be asked to provide your Company Name, Email address and a Password to login and start using Orangescrum.
Note: If you're unable to see the Sign up page, then change the "Configure::write('debug',2)" to "Configure::write('debug',0)" or vice-versa in app/Config/core.php. Once the sign up page appears, change the debug value to "0" and save it
Congratulations! Orangescrum is successfully installed and ready to track your time, projects and tasks.
A Fresh Linux Server (Ubuntu 16 or 18, CentOS 7 and Debian 9)
Internet Connection
Email ID
Email Password
Email SMTP Mail Server Hostname / Private Mail Server Hostname (e.g., mail.gmail.com or smtp.yahoo.com, etc.)
SMTP Port (e.g., 25, 465, 587, etc.)
Note: If Gmail ID is used for SMTP configuration, make sure to enable the "less secure app" function. You can do this by logging into the gmail account and go to "My Accounts" then click on "Sign-in & Security" and enable the "Allow less secure apps: ON".
Note: Make sure to whitelist the application server Domain/IP address from the private Mail Server.
Note: Orangescrum will only work on MySQL 5.6 or 5.7, Apache 2.4 and PHP 7.2
Download Orangescrum
Download the latest release Orangescrum v1.8.0 from here:
Extract the zip file. Upload all the files and folders to your working directory.
Provide proper write permission to "app/tmp" and "app/webroot" folders and their sub-folders.
Make sure that there are three .htaccess files. One in the root directory, another in the "app" directory and the last one is in the "app/webroot" directory.
Make sure that the .htaccess is working in your server.
Create a new MySQL database ('utf8_unicode_ci' collation)
Get the database.sql file from the root directory and import that to your database
Locate your 'app' directory, do the changes on following files
app/Config/database.php
Update the database connection details. (host, login, password and database name)
app/Config/constants.php
Provide your valid Gmail ID and Password for SMTP email sending Or, you can use Sendgrid or Mandrill.
FROM_EMAIL_NOTIFY All the task created/updated notification email will be sent from this Email ID.
SUPPORT_EMAIL All other Emails and support related Emails will be sent from this Email ID.
SUB_FOLDER -Update the folder name, If your application URL is "http://www.myorangescrum.com/folder_name/" (the value should follow by a forward slash. e.g. define('SUB_FOLDER', folder_name/')). Leave it blank If your application URL doesn’t have an additional folder path.
The 1-minute Orangescrum Installation
Open your browser and run Orangescrum the http://yoursiteurl.com/. If Orangescrum is hosted on a local network, then run http://localhost/orangescrum-master or run the IP/domain as configured.
If everything is configured correctly, you should see the Orangescrum Installation Wizard.
MySQL Database Setup
Once you hit the URL, you can see the Database Configuration Wizard
On the Database Configuration wizard, provide your Database Name, Database Host, Username, Password and click Next button.
Note: You should already have MySQL database password as you have provided in earlier steps.
SMTP Configuration
SMTP configuration is needed for email notifications and email replies to post as comments. Without SMTP, you can add users in the latest release v1.8.0.
On the SMTP Configuration Wizard, configure the SMTP with Host Name, Port, Username and Password.
Note: You can Skip SMTP setup by clicking on "Skip". Also, this step doesn’t verify your SMTP configuration. Follow the SMTP troubleshooting to fix the SMTP/Email notification issue.
Congratulations!
Once you click on the "Finish" button, you'll be asked to provide your Company Name, Email address and a Password to login and start using Orangescrum.
Note: If you're unable to see the Sign up page, then change the "Configure::write('debug',2)" to "Configure::write('debug',0)" or vice-versa in app/Config/core.php. Once the sign up page appears, change the debug value to "0" and save it.
Congratulations! Orangescrum is successfully installed and ready to track your time, projects and tasks.
Next Step: Cron Job Settings (Linux Server)
Update your application url in define('DOMAIN', "www.myorangescrum.com/") in the "app/Config/constants.php". Below are the 4 Cron Jobs to set on a Linux server,
(Assuming your Application is in "/var/www/html/orangescrum-master/")
Make sure to do the following changes on the Email server connection details in the app/webroot/EmailReply.php file.
$username This will be the FROM_EMAIL_NOTIFY Email set on your app/Config/constants.php
All the task created/updated notification email will be sent from FROM_EMAIL_NOTIFY. When somebody will reply to that task created/updated notification email, the FROM_EMAIL_NOTIFYwill get that Email in the inbox.
EmailReply.php page is going to read the emails from FROM_EMAIL_NOTIFY and It will post them as a reply to the respective tasks in Orangescrum.
$password- Password of FROM_EMAIL_NOTIFY
client- Change it, if you are not using Gmail
After this setup, you can reply to a task created/updated notification email and that email reply will be posted to Orangescrum under that Task. This will help you to respond to a task while on-the-go from your Mobile.
(Assuming your Application is in "/var/www/html/orangescrum-master/")
Enable extension=php_imap in your php.ini file.
Create a orangescrum.sh file in your server
vi orangescrum.sh(or, open that file to write the below code) #!/bin/bash while(true) do cd /var/www/html/orangescrum-master/app/webroot php q EmailReply.php 1>&2 sleep 1; done
Give the execute permission for orangescrum.sh: chmod +x orangescrum.sh
Start the Nohup using the command: nohup sh orangescrum.sh > customout.log &
Node JS Setup
Make sure that you have installed Node.js and NPM
Install Socket.io using NPM
Install Forever
Find how to add a JavaScript file to run Node.js forever.
Now enable the "NODEJS_HOST" with your server details under "define("NODEJS_HOST", '');"[ex: http://your IP address:3002/] on "app/Config/constants.php"