Thank you for Downloading!

Schedule Enterprise Self-hosted Demo

Schedule Now
X
Back to Download Page

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.

Table of contents (Automated Installation Guide)

  1. Getting Started
  2. Check you meet the minimum requirements
  3. Download Orangescrum
  4. Start the Installation
  5. Installation Guide for CentOS 7
  6. Installation Guide for Ubuntu 16 or Ubuntu 18
  7. Installation Guide for Debian 9
  8. The 1-minute Orangescrum Installation
    1. MySQL Database Setup
    2. SMTP Configuration
    3. Congratulations
  9. Common Installation FAQs

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.

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

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.0 php7.0-curl php7.0-gd php7.0-cli mysql-server php7.0-mysql php-xml php7.0-mbstring

Other required Parameters:

  • 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:

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:
    [[email protected] ~] $ sudo su - [sudo] password for andola
  4. Change the directory to "/tmp" by using the following command:
    [[email protected] ~] # cd /tmp

Installation Guide for CentOS 7

  1. 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",
  2. To unzip Orangescrum PHP 7.2 setup script, use the following command:
    tmp]# unzip os-php72-setup.zip
  3. Give permission to the script file:

    For Orangescrum PHP 7.2 script, use the following command:

    tmp]# chmod +x os-php72-setup
  4. Run the script file: For Orangescrum PHP 7.2 script, use the following command:
    tmp]# ./os-php72-setup
  5. 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:
  6. 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.
  7. The database details you will enter on step 10 are displayed as shown below which you need during the Orangescrum Installation wizard.
  8. Next step the "The 1-minute Orangescrum Installation step".

Installation Guide for Ubuntu 16 or Ubuntu 18

Before installing for Ubuntu 16 or Ubuntu 18, make sure you follow the steps mentioned in "Start the Installation"

  1. To unzip the download file, install unzip extension for Ubuntu: "apt-get -y install unzip",
  2. To unzip Orangescrum PHP 7.2 setup script, use the following command:
    tmp]# unzip os-php72-setup.zip
  3. Give permission to the script file:
    For Orangescrum PHP 7.2 script, use the following command:
    tmp]# chmod +x os-php72-setup
  4. Run the script file:
    For Orangescrum PHP 7.2 script, use the following command:
    tmp]# ./os-php72-setup
  5. 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:
  6. Re-enter the password as per the above given screen-shot.
  7. Please enter the password below which you have created in the above steps:
  8. After installing MySQL database, follow the steps to setup the phpMyAdmin:
    1. Select "apache2" and press "ok" to re-configure the Web Server automatically
    2. Select "Yes" to re-configure the database for phpMyAdmin with dbconfig-common:
      Ubuntu PhpMyadmin Configure
    3. Enter MySQL application password for phpMyAdmin, Enter the Database password you have just created:
      Ubuntu Mysql Password
  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.
  10. The database details you will enter on step 10 are displayed as shown below which you need during the Orangescrum Installation wizard.
  11. Next step the "The 1-minute Orangescrum Installation step".

Installation Guide for Debian 9

Before installing for Debian 9, make sure you follow the steps mentioned in "Start the Installation"

  1. To unzip the download file, install unzip extension for Ubuntu: "apt-get -y install unzip",
  2. To unzip Orangescrum PHP 7.2 setup script, use the following command:
    tmp]# unzip os-php72-setup.zip
  3. Give permission to the script file:
    For Orangescrum PHP 7.2 script, use the following command:
    tmp]# chmod +x os-php72-setup
  4. Run the script file:
    For Orangescrum PHP 7.2 script, use the following command:
    tmp]# ./os-php72-setup
  5. 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:
  6. 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:
  7. Please enter the password below which you have created in the above steps:
  8. After installing MySQL database for Debian 9, follow the steps to setup the phpMyAdmin:
    1. Select "apache2" and press "ok" to re-configure the Web Server automatically
      Debian Apache Configure
    2. Select "Yes" to re-configure the database for phpMyAdmin with dbconfig-common:
      Debian PhpMyadmin Configure
    3. Enter MySQL application password for phpMyAdmin, Enter the Database password you have just created:
      Debian Mysql Password
    4. Re-Confirm the database password:
      Debian Mysql Password Reconform
    5. Please provide the Administrative user's Password to create and modify database
      Administrative user’s Password
  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.
    Required packages
  10. The database details you will enter on step 10 are displayed as shown below which you need during the Orangescrum Installation wizard.
    Database Details
  11. Next step: Follow The 1-minute Orangescrum Installation

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 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.

Common Installation FAQs:

Book a Demo
Contact Us