Just a moment... we're setting up your account.
Please don't refresh or close this page.
Loader
  • Product Support
  • Contact Sales
  • Book a Demo
#1 Productivity Tool Open Source Edition
  • On-Premise
  • Features
    • Resource Management
    • Time Tracking
    • Schedule Management
    • Agile Project Management
    • Budget & Cost Management
    • Bug & issue Tracking
    • Workflow Management
  • Solutions
    • IT Teams
    • Marketing Teams
    • Remote Teams
    • Creative Teams
    • Government
    • Healthcare
    • Banking & Finance
    • Non Profit Organization
  • Support
    • Installation Guide
    • Demo
    • FAQ
    • Consulting
    • Support Plan
    • Release Note
    • Roadmap
    • Customization
  • Download
  • Try Free
    • Work Sign up
    • Agile Sign up
Close

Contact the Orangescrum team

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!

Close

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.

Orangescrum Installation Guide

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 and dedicated server.
  • Access to your web server (via shell or FTP)
  • A FTP Client (if you are installing Orangescrum on a remote server)
  • 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.
  • 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

Recommended Servers sizing (CPU, RAM, Disks)

App server minimum recommended configuration

  • RAM: minimum 4 GB
  • 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:

$ sudo apt-get install php7.2 php7.2-curl php7.2-gd php7.2-cli php7.2-mysql php7.2-mbstring

Other required Parameters:

App server minimum recommended configuration

  • A Fresh Linux Server (Ubuntu 16 or 18, CentOS 7 and Debian 9)
  • Internet Connection
  • Email ID
  • Email Password
Note:
  • Make sure to whitelist the application server Domain/IP address from the private Mail Server.
  • 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 Open source

Download the latest release Orangescrum open-source from GitHub:

Download Orangescrum for free

Start the Installation

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.

  1. 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:
    1. Installs required packages and dependencies to support the application
    2. Installs and configure Apache Web Server
    3. 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.
    4. Setup cron jobs
  2. 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
  3. Login to "root" or run "sudo su -", enter the root password:
    [test@localhost ~] $ sudo su - [sudo] password for test
  4. Change the directory to "/tmp" by using the following command

Installation Guide for Different Versions:

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.

loader

Automated Installation Guide for CentOS 7
(PHP 7.2)

Note:

This script will not work on shared hosting, only work on CentOS dedicated server only

Prerequisites:

Hardware Software
RAM: minimum 4 GB Apache 2.4
Processor: Core2duo or Higher PHP = 7.2
OS: CentOS 7 MySQL 5.6 or 5.7
Disk Space: 10 GB or Higher Imagemagick

PHP Extensions we are using:

Extension Name Usage
php-cli PHP CLI is a short for PHP Command Line Interface. So kind of command line work such as running scheduled (CRON), making GUI applications etc. can be done using php-cli. We are using php-cli for CRON.
php-common PHP common consists of all the common module and .so file that is required to run PHP in a server.
php-dba Required to handle database connections, key base access, list database connection, etc.
php-enchant Enchant provide uniformity and conformity on top of all spelling libraries, and implement certain features that may be lacking in any individual provider library. So it used spell check.
php-fpm FPM (FastCGI Process Manager) is an alternative PHP FastCGI implementation with some additional features (mostly) useful for heavy-loaded sites. It is used for making site to load faster.
php-gd It is used to create and manipulate image files in a variety of different image formats.
php-imap These functions enable you to operate with the IMAP protocol, as well as the POP3 and local mailbox access methods. We are using this to read email reply from notify email and posting to Orangescrum.
php-intl It is enabling PHP programmers to perform various locale-aware operations including but not limited to formatting, transliteration, encoding conversion, calendar operations, collation, locating text boundaries and working with locale identifiers, time zones etc. This is required for Orangescrum’s multilingual feature.
php-ldap LDAP is the Lightweight Directory Access Protocol, and is a protocol used to access "Directory Servers". The Directory is a special kind of database that holds information in a tree structure. It optional, it required for the LDAP plugin for Orangescrum otherwise not required.
php-mbstring Multi-byte character handling
We are using this in the php functions such as trim, split, splice, etc.
php-mysql Used to connect MySQL database from PHP environment using the PDO library.
php-pdo The PHP Data Objects (PDO) extension defines a lightweight, consistent interface for accessing databases in PHP. Cakephp is using PDO to communicate with the MySQL database to perform database operations (fetch, insert, update and delete records)
php-pecl-zip A zip management extension. We are using this to creating zip files. ex while downloading task we are creating zip.
php-pecl-memcache Memcached is a caching daemon designed especially for dynamic web applications to decrease database load by storing objects in memory. We are supporting memcache. it is optional, default cache for cakephp if fileCache.
php-pecl-imagick Imagick is a native php extension to create and modify images using the ImageMagick API. We are using this extension to crop images as per user’s requirement and also to display thumbnails for larger size images.
php-tidy Tidy is a binding for the Tidy HTML clean and repair utility which allows you to not only clean and otherwise manipulate HTML, XHTML, and XML documents, but also traverse the document tree, including ones with embedded scripting languages such as PHP or ASP within them using object oriented constructs.
php-xml PHP xml is an xml parser.
php-opcache OPcache improves PHP performance by storing precompiled script byte code in shared memory, thereby removing the need for PHP to load and parse scripts on each request.
php-devel PHP development library
php-pear A structured library of open-source code for PHP users. A system for code distribution and package maintenance.
php-curl PHP supports libcurl, a library created by Daniel Stenberg, that allows you to connect and communicate to many different types of servers with many different types of protocols. libcurl currently supports the http, https, ftp, gopher, telnet, dict, file, and ldap protocols. We are using this sending push notifications and checking file existence.

OS and Other required Parameters:

  • A Fresh CentOS Server
  • Internet Connection
  • Email ID
  • Email Password
Note: If Gmail ID 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 works on MySQL 5.6 & 5.7, Apache 2.4 and PHP 7x

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

What does the installation package help with?

  • 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

Steps to install application:

  1. Download the Orangescrum Open-source Edition Package.
  2. Copy it 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

  3. Login to "root" or run "sudo su -", enter the root password:
    [andola@localhost ~ ] $ sudo su -
    [sudo] password for andola :
  4. Change the directory to “/tmp” by using the following command:
    [root@localhost ~ ] # cd / tmp
    [root@localhost tmp ] #

    The downloaded package is in zip format, to extract the file you need unzip command, If you don’t have unzip command follow the steps::

    Install unzip by typing: "yum -y install unzip", then unzip the code:

    tmp] # unzip Orangescrum-Selfhosted-* .zip
  5. Change the directory to "orangescrum":
    tmp] # cd orangescrum/
  6. Give permission to the script file "setup"
    orangescrum] # chmod +x setup
  7. Run the setup file:
    orangescrum] # ./setup
  8. 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:
    Installation
  9. 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.
    Installation
  10. The database details you will enter on step 9 are displayed as shown below which you need during the Orangescrum Installation wizard.
    Installation
  11. Run Orangescrum as http://yoursiteurl.com/ from your browser. If Orangescrum is hosted on local network, then run http://localhost/orangescrum-master or run the IP/domain as configured.
  12. Once you hit the URL, you can see the Database Configuration Wizard.
  13. On the Database Configuration wizard, provide your Database Name, Database Host, Username, Password and click Next button.
    Database Configuration
  14. Clicking the next button will redirect to Signup page, where you can create your account and use the application.

Automated Installation Guide for Ubuntu 16
(PHP 7.2)

Note:

This script will not work on shared hosting, only works on Ubuntu 16 dedicated server only

Prerequisites:

Hardware Software
RAM: minimum 4 GB Apache 2.4
Processor: Core2duo or Higher PHP = 7.2
OS: Ubuntu 16 MySQL 5.6 or 5.7
Disk Space: 10 GB or Higher Imagemagick

PHP Extensions we are using:

Extension Name Usage
php-cli PHP CLI is a short for PHP Command Line Interface. So kind of command line work such as running scheduled (CRON), making GUI applications etc. can be done using php-cli. We are using php-cli for CRON.
php-common PHP common consists of all the common module and .so file that is required to run PHP in a server.
php-dba Required to handle database connections, key base access, list database connection, etc.
php-enchant Enchant provide uniformity and conformity on top of all spelling libraries, and implement certain features that may be lacking in any individual provider library. So it used spell check.
php-fpm FPM (FastCGI Process Manager) is an alternative PHP FastCGI implementation with some additional features (mostly) useful for heavy-loaded sites. It is used for making site to load faster.
php-gd It is used to create and manipulate image files in a variety of different image formats.
php-imap These functions enable you to operate with the IMAP protocol, as well as the POP3 and local mailbox access methods. We are using this to read email reply from notify email and posting to Orangescrum.
php-intl It is enabling PHP programmers to perform various locale-aware operations including but not limited to formatting, transliteration, encoding conversion, calendar operations, collation, locating text boundaries and working with locale identifiers, time zones etc. This is required for Orangescrum’s multilingual feature.
php-ldap LDAP is the Lightweight Directory Access Protocol, and is a protocol used to access "Directory Servers". The Directory is a special kind of database that holds information in a tree structure. It optional, it required for the LDAP plugin for Orangescrum otherwise not required.
php-mbstring Multi-byte character handling
We are using this in the php functions such as trim, split, splice, etc.
php-mysql Used to connect MySQL database from PHP environment using the PDO library.
php-pdo The PHP Data Objects (PDO) extension defines a lightweight, consistent interface for accessing databases in PHP. Cakephp is using PDO to communicate with the MySQL database to perform database operations (fetch, insert, update and delete records)
php-pecl-zip A zip management extension. We are using this to creating zip files. ex while downloading task we are creating zip.
php-pecl-memcache Memcached is a caching daemon designed especially for dynamic web applications to decrease database load by storing objects in memory. We are supporting memcache. it is optional, default cache for cakephp if fileCache.
php-pecl-imagick Imagick is a native php extension to create and modify images using the ImageMagick API. We are using this extension to crop images as per user’s requirement and also to display thumbnails for larger size images.
php-tidy Tidy is a binding for the Tidy HTML clean and repair utility which allows you to not only clean and otherwise manipulate HTML, XHTML, and XML documents, but also traverse the document tree, including ones with embedded scripting languages such as PHP or ASP within them using object oriented constructs.
php-xml PHP xml is an xml parser.
php-opcache OPcache improves PHP performance by storing precompiled script byte code in shared memory, thereby removing the need for PHP to load and parse scripts on each request.
php-devel PHP development library
php-pear A structured library of open-source code for PHP users. A system for code distribution and package maintenance.
php-curl PHP supports libcurl, a library created by Daniel Stenberg, that allows you to connect and communicate to many different types of servers with many different types of protocols. libcurl currently supports the http, https, ftp, gopher, telnet, dict, file, and ldap protocols. We are using this sending push notifications and checking file existence.

OS and Other required Parameters:

  • A Fresh Ubuntu Server
  • Internet Connection
  • Email ID
  • Email Password
Note: If Gmail ID 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 works on MySQL 5.6 & 5.7, Apache 2.4 and PHP 7.x

What does the installation package help with?

  • 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 configured user, requires existing root password.
  • Setup cron jobs

Steps to install application:

  1. Download the Orangescrum Open-source Edition Package.
  2. Copy it 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

  3. Login to "root" or run "sudo su -", enter the root password:
    [andola@localhost ~ ] $ sudo su -
    [sudo] password for andola :
  4. Change the directory to "/tmp" by using the following command:
    [root@localhost ~ ] # cd / tmp
    [root@localhost tmp ] #
  5. The downloaded package is in zip format, to extract the file you need unzip command, If you don’t have unzip command follow the steps:

    Install unzip by typing: "apt-get -y install unzip", then unzip the code:

    tmp] # unzip Orangescrum-Selfhosted-* .zip
  6. Change the directory to "orangescrum":
    tmp] # cd orangescrum/
  7. Give permission to the script file "setup"
    orangescrum] # chmod +x setup
  8. Run the setup file:
    orangescrum] # ./setup
  9. 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:
    Installation

    Re-enter the password as per the above given screen-shot.

    Installation

    Please enter the password below which you have created in the above steps:

    Installation
  10. After installing MySQL database, follow the steps to setup the phpMyAdmin:
    • Select "apache2" and press "ok" to re-configure the Web Server automatically
      Installation
    • Select "Yes" to re-configure the database for phpMyAdmin with dbconfig-common:
      Installation
    • Enter MySQL application password for phpMyAdmin, Enter the Database password you have just created:
      Installation
  11. 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.
    Installation
  12. The database details you will enter on step 9 are displayed as shown below which you need during the Orangescrum Installation wizard.
    Installation
  13. Run Orangescrum as http://yoursiteurl.com/ from your browser. If Orangescrum is hosted on local network, then run http://localhost/orangescrum-master or run the IP/domain as configured.
  14. Once you hit the URL, you can see the Database Configuration Wizard.
  15. On the Database Configuration wizard, provide your Database Name, Database Host, Username, Password and click Next button.
    Database Configuration

Automated Installation Guide for Ubuntu 18
(PHP 7.2)

Note:

This script will not work on shared hosting, only works on Ubuntu 18 dedicated server only.

Prerequisites:

Hardware Software
RAM: minimum 4 GB Apache 2.4
Processor: Core2duo or Higher PHP = 7.2
OS: Ubuntu 18 MySQL 5.6 or 5.7
Disk Space: 10 GB or Higher Imagemagick

PHP Extensions we are using:

Extension Name Usage
php-cli PHP CLI is a short for PHP Command Line Interface. So kind of command line work such as running scheduled (CRON), making GUI applications etc. can be done using php-cli. We are using php-cli for CRON.
php-common PHP common consists of all the common module and .so file that is required to run PHP in a server.
php-dba Required to handle database connections, key base access, list database connection, etc.
php-enchant Enchant provide uniformity and conformity on top of all spelling libraries, and implement certain features that may be lacking in any individual provider library. So it used spell check.
php-fpm FPM (FastCGI Process Manager) is an alternative PHP FastCGI implementation with some additional features (mostly) useful for heavy-loaded sites. It is used for making site to load faster.
php-gd It is used to create and manipulate image files in a variety of different image formats.
php-imap These functions enable you to operate with the IMAP protocol, as well as the POP3 and local mailbox access methods. We are using this to read email reply from notify email and posting to Orangescrum.
php-intl It is enabling PHP programmers to perform various locale-aware operations including but not limited to formatting, transliteration, encoding conversion, calendar operations, collation, locating text boundaries and working with locale identifiers, time zones etc. This is required for Orangescrum’s multilingual feature.
php-ldap LDAP is the Lightweight Directory Access Protocol, and is a protocol used to access "Directory Servers". The Directory is a special kind of database that holds information in a tree structure. It optional, it required for the LDAP plugin for Orangescrum otherwise not required.
php-mbstring Multi-byte character handling
We are using this in the php functions such as trim, split, splice, etc.
php-mysql Used to connect MySQL database from PHP environment using the PDO library.
php-pdo The PHP Data Objects (PDO) extension defines a lightweight, consistent interface for accessing databases in PHP. Cakephp is using PDO to communicate with the MySQL database to perform database operations (fetch, insert, update and delete records)
php-pecl-zip A zip management extension. We are using this to creating zip files. ex while downloading task we are creating zip.
php-pecl-memcache Memcached is a caching daemon designed especially for dynamic web applications to decrease database load by storing objects in memory. We are supporting memcache. it is optional, default cache for cakephp if fileCache.
php-pecl-imagick Imagick is a native php extension to create and modify images using the ImageMagick API. We are using this extension to crop images as per user’s requirement and also to display thumbnails for larger size images.
php-tidy Tidy is a binding for the Tidy HTML clean and repair utility which allows you to not only clean and otherwise manipulate HTML, XHTML, and XML documents, but also traverse the document tree, including ones with embedded scripting languages such as PHP or ASP within them using object oriented constructs.
php-xml PHP xml is an xml parser.
php-opcache OPcache improves PHP performance by storing precompiled script byte code in shared memory, thereby removing the need for PHP to load and parse scripts on each request.
php-devel PHP development library
php-pear A structured library of open-source code for PHP users. A system for code distribution and package maintenance.
php-curl PHP supports libcurl, a library created by Daniel Stenberg, that allows you to connect and communicate to many different types of servers with many different types of protocols. libcurl currently supports the http, https, ftp, gopher, telnet, dict, file, and ldap protocols. We are using this sending push notifications and checking file existence.

OS and Other required Parameters:

  • A Fresh Ubuntu Server
  • Internet Connection
  • Email ID
  • Email Password
Note: If Gmail ID 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 works on MySQL 5.6 & 5.7, Apache 2.4 and PHP 7.x

What does the installation package help with?

  • 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 configured user, requires existing root password.
  • Setup cron jobs

Steps to install application:

  1. Download the Orangescrum Open-source Edition Package.
  2. Copy it 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

  3. Login to "root" or run "sudo su -", enter the root password:
    [andola@localhost ~ ] $ sudo su -
    [sudo] password for andola :
  4. Change the directory to "/tmp" by using the following command:
    [root@localhost ~ ] # cd / tmp
    [root@localhost tmp ] #
  5. The downloaded package is in zip format, to extract the file you need unzip command, If you don’t have unzip command follow the steps:

    Install unzip by typing: "apt-get -y install unzip", then unzip the code:

    tmp] # unzip Orangescrum-Selfhosted-* .zip
  6. Change the directory to "orangescrum":
    tmp] # cd orangescrum/
  7. Give permission to the script file "setup"
    orangescrum] # chmod +x setup
  8. Run the setup file:
    orangescrum] # ./setup
  9. 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:
    Installation

    Re-enter the password as per the above given screen-shot.

    Installation

    Please enter the password below which you have created in the above steps:

    Installation
  10. After installing MySQL database, follow the steps to setup the phpMyAdmin:
    • Select "apache2" and press "ok" to re-configure the Web Server automatically
      Installation
    • Select "Yes" to re-configure the database for phpMyAdmin with dbconfig-common:
      Installation
    • Enter MySQL application password for phpMyAdmin, Enter the Database password you have just created:
      Installation
  11. 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.
    Installation
  12. The database details you will enter on step 9 are displayed as shown below which you need during the Orangescrum Installation wizard.
    Installation
  13. Run Orangescrum as http://yoursiteurl.com/ from your browser. If Orangescrum is hosted on local network, then run http://localhost/orangescrum-master or run the IP/domain as configured.
  14. Once you hit the URL, you can see the Database Configuration Wizard.
  15. On the Database Configuration wizard, provide your Database Name, Database Host, Username, Password and click Next button.
    Database Configuration

Manual Installation Guide for Ubuntu_0211

Below are the steps to install Orangescrum Open-source version of Cloud Edition in Ubuntu Server

Step 1:

Download the Orangescrum Open-source version of Cloud Edition.

Extract the archive file.

You will find the following list in files/folder

  • orangescrum - folder

    You will find user license wise sql file (Ex. database.sql) inside orangescrum folder.

  • installationmanual.pdf
  • Perpetual license doc
Note: If Gmail ID used 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 the 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 works on MySQL 5.4-5.7, Apache 2.4 and PHP 7.x

Step 2:

Required packages to install: PHP, MySQL, Apache

Requirement:

* Apache with `mod_rewrite`

* Enable curl in php.ini

* Change the 'post_max_size' and `upload_max_filesize` to 200Mb in php.ini

PHP 7.2

Required PHP Extensions:

Php7.2-gd

Php7.2-cur

Php7.2-common

Php7.2-fpm

Php7.2-mcrypt

Php7.2-cli

Php7.2-imap

Php7.2-intl

Php7.2-opcache

Php7.2-ldap

Php7.2-xml

Php7.2-mysql

Php7.2-tidy

Php7.2-mbstring

Php7.2-soap

Php7.2-zip

Php7.2-dba

* MySQL 5.6 – 5.7

* If STRICT mode is On, turn it Off.

Step 3:

  • Extract the archive file.
  • Upload folder (orangescrum) to your working directory (/var/www/html).
  • Provide proper write permission to oranegscrum folder and their subfolders.
  • Provide proper write permission to " app/tmp" folders and their sub folders
  • Provide Proper ownership to oranegscrum folder and their sub folders.

chmod -R 0755 /var/www/html/orangescrum

chmod -R 0777 app/tmp

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

Step 4:

Install the Apache Server

sudo apt-get install build-essential

sudo apt-get install apache2

Enable and start your apache

sudo systemctl enable apache2

Start Apache Service

sudo systemctl start/status/stop apache2

Step 5:

Install MySQL

sudo apt install -y mysql-server

sudo systemctl enable mysql

During installation, you’ll be asked to setup the MySQL “root” user password. Enter the password and click Ok.

Installation

Re-enter the password.

Installation

You can verify the MySQL server status using command:

sudo systemctl status mysql
OR
sudo service mysql status

Manage MySQL Databases (Optional)

Install phpMyAdmin(To access database Graphically):

phpMyAdmin is a free open-source web interface tool used to manage your MySQL databases. It is available in the Official Debian repositories. So install it with command:

sudo apt-get install phpmyadmin

Select the Web server that should be automatically configured to run phpMyAdmin. In my case, it is apache2.

Installation

Select ‘Yes’ to configure database for phpmyadmin with dbconfig-common

Installation

Enter password of the database’s administrative user.

Installation

Enter MySQL application password for phpmyadmin:

Installation

Re-enter password:

Installation

Additional Note: if you followed all steps carefully, phpMyAdmin should work just fine. In case phpMyAdmin is not working, please do the following steps.

Open terminal, and type:

sudo vim /etc/apache2/apache2.conf

Add the following line at the end.

Include /etc/phpmyadmin/apache.conf

Save and Exit and Restart apache service:

sudo systemctl restart apache2 or sudo service apache2 restart

Access phpMyAdmin Web Console

Now, you can access the phpmyadmin console by navigating to http://server-ip- address/phpmyadmin/ from your browser.Enter your MySQL username and password which you have given in previous steps

Installation

Step 6

Login To MySQL & Create Database named "orangescrum"

login to mysql:

[root@server ~]# mysql -u root -p

Enter password:

create the database:

mysql> create database orangescrum;

verify that it's there:

mysql> show databases;

create the user:

mysql> create user orangescrum;

Grant all privileges while assigning the password:

mysql> grant all on orangescrum.* to 'orangescrum'@'localhost' identified by 'your_password';

Exit from the database:

mysql> exit

Import database sql file:

Navigate folder name directory by typing :

cd /var/www/html/orangescrum
[root@server ~]# mysql -u orangescrum(User Name) -p orangescrum(Database name) < database.sql(Database sql File)

Enter password:

Login to the database and check whether your tables are created or not:

[root@server ~]# mysql -u orangescrum(User Name) -p

Enter password:

mysql> show databases;

if your database exist then trigger the below command:

mysql> use orangescrum(Database name);
mysql> show tables;
mysql> exit

We have already updated the database name as "Orangescrum" which you can change at any point. In order to change it, just create a database using any name and update that name as database in DATABASE_CONFIG section. And also you can set a password for your Mysql login which you will have to update in the same page as password. [Required]

Step 7

Install PHP:

Install the PHP Packages: (Recommended Version PHP 72)

sudo apt-get -y install libpython-stdlib libpython2.7-minimal libpython2.7-stdlib python python- sudo apt python-minimal python-pycurl python-software-properties python2.7 python2.7- minimal

sudo add-apt-repository ppa:ondrej/php

sudo apt-get update

apt-get -y install Php7.2 Php7.2-cgi Php7.2-cli Php7.2-common Php7.2-curl Php7.2-dba Php7.2- fpm Php7.2-gd Php7.2-imap Php7.2-intl Php7.2-ldap Php7.2-mbstring Php7.2-mcrypt Php7.2- mysql Php7.2-opcache php-imagick php-memcache Php7.2-soap Php7.2-tidy Php7.2-xml Php7.2-zip libapache2-mod-Php7.2

a2enmod proxy_fcgi setenvif

a2enconf php7.2-fpm

service apache2 restart

Check for php version:

php –v

Step 8

Setup the database information in app/config/database.php

Update the database connection details. (host, login, password and database name).

Step 9

Create a virtual host file

vim /etc/apache2/sites-available/os.conf

Add this below details to last line of os.conf file

<VirtualHost *:80>
ServerName localhost # eg: demo.orangescrum.com
DocumentRoot /var/www/html/orangescrum/
<Directory /var/www/html/orangescrum/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>
</VirtualHost>

Save the file and Restart the Apache service

systemctl restart apache2

OR

service apache2 restart

cd /etc/apache2/sites-available/

a2dissite 000-default.conf

service apache2 reload

a2ensite os.conf

service apache2 restart

Issue on Ubuntu with respect to htaccess:

Open this file and edit

vim /etc/apache2/apache2.conf

Add this below file ( AllowOverride All instead of AllowOverride None)

<Directory /var/www/html/>
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>

Save the file and restart the Apache service.

Enable this module and restart the Apache service

sudo a2enmod rewrite
sudo a2enmod headers
service apache2 restart

Step 10

General Configuration management:

MySQL:

If STRICT mode is On, turn it Off.

Disable Strict mode on mysql for Ubuntu:

To disable strict SQL mode

Create the below file

vim /etc/mysql/conf.d/disable_strict_mode.cnf

and enter those two lines on it: =

[mysqld]

sql_mode=IGNORE_SPACE,NO_ZERO_IN_DATE, NO_ZERO_DATE,ERROR_FOR_DIVISION_BYZE RO, NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION

Then save the file and restart the mysql server

sudo service mysql restart

OR

sudo systemctl restart mysql

Make sure that, the .htaccess is working in your server.

Step 11

Email Reply - Nohup Cron Job setup (Linux Server)

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_EC Email set on your app/Config/constants.php

All the task created/updated notification email will be sent from FROM_EMAIL_EC . When somebody will reply on that task created/updated notification email, the FROM_EMAIL_EC will get that Email in the inbox.

EmailReply.php page is going to read the emails from FROM_EMAIL_EC and It will post to them as a reply to the respective tasks in Orangescrum.

$password- Password of FROM_EMAIL_EC

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/ ")

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/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 &

Step 12

Browse the Orangescrum website http://YourIpAddress or server IP address or domain name. Ex. http://localhost/orangescrum

Step 13

You will be asked to provide your Company Name, Email address and a Password to login and start using Orangescrum.

Step 14

Profile Setting

  • Go to Setting, click on My profile to set up your profile photo
  • Select Time zone for your account
  • Click on Update to save the changes

Notifications Setting

  • Go to Settings
  • Click on Notifications under Profile Setting
  • Select "Yes" to get notifications in your email inbox
  • Click on Email Reports from the Personal setting
  • Select Yes to get Email Reports

Company Setting

  • Go to Settings
  • Select My Company from the Company Settings
  • Select "Yes" to get notifications in your email inbox
  • Upload the company logo and click on Update to save changes

For Any Queries, Contact us: support@orangescrum.com

Manual Installation Guide for Windows_0211

Below are the steps to install Orangescrum Cloud Edition on windows environment.

Step 1:

Download the Orangescrum Open-source version of Cloud Edition

Extract the archive file.

You will find the following list in files/folder

  • orangescrum - folder

    You will find user license wise sql file (Ex. database.sql) inside orangescrum folder.

  • installationmanual.pdf
  • Perpetual license doc

Step 2:

Download XAMPP with PHP version 7.0.32 (https://www.apachefriends.org/download.html)

Step 3:

Then, Install XAMPP on the Windows Machine.Refer the steps provided below to Setup XAMPP.

  1. Right click on the XAMPP installer package and "Run as Administrator" to open the installer screen as shown below.
    Installation
  2. Click on Next to Proceed.
    Installation
  3. Then, click Next to proceed installation using the default settings. You can edit the settings as per your requirement.
    Installation
  4. Create a folder Named "XAMPP" under any directory and browse it to select it as the installation folder as shown in the below image.
    Installation
  5. Click Next to Proceed.
    Installation
  6. Click Next to Proceed.
    Installation
  7. Now you will be see the progress as shown in the below image.
    Installation
  8. Click on Finish to start XAMPP.
  9. Start Apache and Mysql services from the XAMPP control panel as shown below.
    Installation
  10. Browse http://localhost/ and select your language to open the page as shown below.
    Installation

Step 4:

Now, you will be able to view the page as shown below. Click on "PhpMyadmin" to open PhpMyadmin link

Installation

You have installed XAMPP successfully on the system. Now you have to create a Database using Phpmyadmin for the application. Refer the steps below to create a Database, user and assign all privileges to the user for the database.

  1. After navigating to PhpMyadmin page, click on the "Users" Tab.
    Installation
  2. Next, Click on the "Add user" option
  3. Now, Enter the fields as shown in the below Image. Create an user, assign a password to it and create a database with the same name as user.
    Installation
  4. Click on Databases Tab to Navigate to the List of Databases page.
    Installation
    Installation
  5. Click on the database name which you have create Earlier.
  6. After choosing the Database, click on the privileges tab to open the privileges settings as shown in the below image.
    Installation
  7. Now grant all privileges (Administration) to the user for the database as shown in the below Image.
    Installation
  8. After Granting all privileges to the user, now import the database to the Mysql server as shown in the below image
    Installation
  9. Click on "Choose file" option to browse for the Database file from the source code(orangescrum) which you have downloaded earlier and click on "Go"
    Installation
  10. Now, you can see the Table Structure under the Database.

    Now, you have to configure the Application with the Apache webserver. Refer the below steps.

Step 5:

Navigate to the XAMPP folder where you have installed the XAMPP software or you may call the installation folder.

  • Paste the source code folder (orangescrum) of Orangescrum folder which you have downloaded earlier and paste it inside the "htdocs" folder as shown in the below image.
    Installation
  • Now, navigate to the orangescrum\app\Config directory.
    Installation
  • Open the database.php file in an editor and change the fields

    ’host’ => ‘localhost’ ’login’ => ‘Root’’password’ =>” ‘database’ =>” To ‘host’ => ‘localhost’ ← The host name should remain Localhost.’login’ => ‘orangescrum’ ← Database username which you have created earlier ‘password’ => ‘*****’ ← Enter the password which you have assigned to the user earlier ‘database’ => ‘Orangescrum’ ← Enter the Database name which you created earlier.

  • Now browse the application by the URl: http://yourIPaddress/orangescrum

Step 6:

You will be asked to provide your Company Name, Email address and a Password to login and start using Orangescrum.

Step 7:

General Configuration management:

MySQL:

  • If STRICT mode is On, turn it Off.
  • Navigate the phpMyAdmin page.
    Installation
  • Look at the top and towards the right for variables. Click on that
    Installation
    Installation
  • Search for sql mode
  • Click on Edit
    Installation
  • Change the Value.
    Installation
  • Click on save.
  • Enable curl in php.ini

    Locate your PHP.ini file

    Open the PHP.ini in notepad

    Search or find the following : ';extension=php_curl.dll'

    Uncomment this by removing the semi-colon ';' before it

    Save and Close PHP.ini

    Restart Apache

  • Change the ‘ post_max_size ‘ and ‘ upload_max_filesize ‘ to 200Mb in php.ini
  • Make sure that, the .htaccess is working in your server.

Step 8:

Profile Setting

  • Go to Setting, click on My profile to set up your profile photo.
  • Select Time zone for your account
  • Click on Update to save the changes

Notifications Setting

  • Go to Settings
  • Click on Notifications under Profile Setting

Company Setting

  • Go to Setting
  • Select My Company from the Company Settings
  • Upload the company logo and click on Update to save changes

For Any Queries, Contact us: support@orangescrum.com

Before you begin Install a Orangescrum application

  1. Getting Started
  2. Check you meet the minimum requirements
  3. Recommended Servers sizing (CPU, RAM, Disks)
  4. Recommended Configuration
  5. Other required Parameters
  6. Download Orangescrum Open source
  7. Start the Installation
  8. Installation Guide for Different Versions
  • #1 Productivity Tool

  • Terms of Use | Privacy Policy

  • © 2011-2025 Orangescrum

Join Our Newsletter

Please enter your email.

Get weekly updates with proven, actionable tips to help you lead your team.
  • Product
  • Orangescrum Cloud
  • Self-Hosted Edition
  • Open-source Edition
  • Orangescrum CRM
  • Knowledge Base
  • Support
  • Installation Guide
  • Demo
  • FAQ
  • Roadmap
  • Community Support
×
By using Orangescrum, you agree to our Privacy Policy.
Accept
Sign up with Google
OR
Set your email to access your account

Please enter your email.

No credit card needed.

Already have an account? Sign in.

Not ready to start your free trial yet?

See why teams prefer Orangescrum

My team (Hailstorm-Development) and I LOVE Orangescrum! We are a flexi-time remote business solution specialist agency, and this tool has enabled us to actually create this company. Without you all, we wouldn't even exist!
  • Hayley Turner
    Hayley Turner

    Founder, Hailstorm Development

Please enter your email.

Free 15-day trial Easy setup Cancel anytime

Let's stay in touch


Submit

<
Talk with our sales team

Required
Required
Required
Required
Required
Required
By clicking "contct us," you acknowledge that your data will be handled in accordance with Orangescrum’s Privacy Policy, and you authorize Orangescrum to send you updates about Orangescrum product.
Get Instant Support
+1 (408) 907 4166 +91 966 846 5389
Schedule a Call
social proofing reviews