Install Orangescrum on an Ubuntu 16.04 VPS


Orangescrum is a free and open source project management and collaboration application, ideal for small and medium businesses. With this application, you can easily create and manage your projects, teams, documents, and tasks and communicate with the other team members on your important issues.

Orangescrum comes with very useful features such as

  • Interactive summary of projects
  • Visual representation
  • All in one screen
  • Project demonstrate
    and much more…

In this tutorial we will install Orangescrum with Apache, PHP and MariaDB on one of our Ubuntu virtual servers.

Orangescrum provides various features like agile project management, collaboration, issue tracking, notifications, reporting, task management, and traditional project management functionality for small/medium businesses.

Login to your Ubuntu server as user root

ssh [email protected]_address

And run the following command from your terminal to make sure that all installed packages are up to date

apt-get update && apt-get -y upgrade

A web server is required for running Orangescrum. Install Apache web server

apt-get install apache2

Orangescrum is a PHP based application, so we will need to install PHP too

apt-get install php7.0 libapache2-mod-php7.0 php7.0-curl php7.0-gd php7.0-mysql php7.0-mcrypt

Install MariaDB database server

apt-get install -y mariadb-server

Once the MariaDB installation is completed, run the ‘mysql_secure_installation’ script to secure the database server and set a root password


Create a new database and user for Orangescrum

[user]$ mysql -u root -p

MariaDB [(none)]> CREATE DATABASE orangescrum;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON orangescrum.* TO 'orangescrumuser'@'localhost' IDENTIFIED BY 'PASSWORD';
MariaDB [(none)]> \q

Do not forget to change ‘PASSWORD’ with an actual, strong password. It is best to use a combination of letters and numbers and minimum 10 characters long.

Download Orangescrum to your server


Unpack it to your document root directory

unzip -d /var/www/html

All Orangescrum files are directory will be unpacked in a new ‘orangescrum-master’ directory. We will rename it to something simpler

mv /var/www/html/orangescrum-master/ /var/www/html/orangescrum

Change the ownership of the directory.

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

Now, change the current working directory and import the Orangescrum data from the database.sql dump file into the newly created MariaDB database

cd /var/www/html/orangescrum/
mysql -u orangescrumuser -p orangescrum < database.sql

Open and modify the ‘database.php’ file to update the database information

vim app/Config/database.php

public $default = array(
'datasource' => 'Database/Mysql',
'persistent' => false,
'host' => 'localhost',
'login' => 'orangescrumuser',
'password' => 'PASSWORD',
'database' => 'orangescrum',
'prefix' => '',
'encoding' => 'utf8',

Save and close the file.

Now, edit the ‘constants.php’ file and update the WEB_DOMAIN, FROM_EMAIL_NOTIFY and SUPPORT_EMAIL fields.

vim app/Config/constants.php

define("WEB_DOMAIN", ""); //ex.
define('FROM_EMAIL_NOTIFY', '[email protected]'); //(REQUIRED)
define('SUPPORT_EMAIL', '[email protected]'); //(REQUIRED) From Email

and save the file.

Create a new virtual host directive in Apache. To do that, create a new Apache configuration file named ‘orangescrum.conf’ on your virtual server:

touch /etc/apache2/sites-available/orangescrum.conf
ln -s /etc/apache2/sites-available/orangescrum.conf /etc/apache2/sites-enabled/orangescrum.conf
vim /etc/apache2/sites-available/orangescrum.conf

with the following content

<VirtualHost *:80>
ServerAdmin [email protected]
DocumentRoot /var/www/html/orangescrum/
<Directory /var/www/html/orangescrum/>
Options FollowSymLinks
AllowOverride All
Order allow,deny
allow from all
ErrorLog /var/log/apache2/
CustomLog /var/log/apache2/ common

Once it is done, restart the web server for the changes to take effect

service apache2 restart

Now, access in your favorite browser and follow the on-screen instructions to complete the Orangescrum installation.

You can check Orangescrum’s official documentation for more information about the application.

Of course you don’t have to do any of this if you use one of our Linux VPS Hosting services, in which case you can simply ask our expert Linux admins to install Orangescrum for you. They are available 24×7 and will take care of your request immediately.

PS. If you liked this post please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.

How to Reset MariaDB Root Password
How to install e107 CMS on Ubuntu 14.04
How to Install Magento 2 with Apache, Varnish and Memcache
  • gorki


    Author Reply

    Hello i follow your auto and i got :
    ERROR 1045 (28000): Access denied for user ‘x2crmuser’@’localhost’ (using password: YES)
    [email protected]:/var/www/html/orangescrum#

    • admin


      Author Reply

      Hi Gorki,

      You should make sure that you entered the correct MySLQ information (login, password, database) in the ‘app/Config/database.php’ file.

  • tim


    Author Reply

    I’m not sure, but I think x2crmuser is a typo.
    maybe its orangescrumuser??

    • admin


      Author Reply

      The post has been updated. Thanks for your feedback.

  • Tim


    Author Reply

    Me again… multiple attempts at setting up a fresh ubuntu 16 vbox.
    unzip master.php -d /var/www/html should be zip instead.

    just a comment, had to install unzip and had to look up how to exit vim.

    Also still can’t get it to work. I got permission issues and had to chown some directories. and now I’m stuck on the 4 simple steps to get started with Orangescrum page. wasn’t sure if (the utf8_unicode_ci` collation) requirement is an issue

    • admin


      Author Reply

      Yes, it should be zip instead of php. We updated the blog post.

Free Migration to RoseHosting. Award Winning Linux VPS Hosting with Fully Managed Support. Coupon RHBLOG50 for 50% offOrder Now