We’ll show you, How to Install Orangescrum on Ubuntu 16.04. 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. Installing Orangescrum on Ubuntu 16.04, is not so complicated and should take less than 10 minutes.
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.
Table of Contents
1. Login via SSH
Login to your Ubuntu server as user root
2. Update the System
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
3. Install Apache Web Server
A web server is required for running Orangescrum. Install Apache web server
apt-get install apache2
4. Install PHP
Orangescrum supports PHP 5.5, so we will need to install the following packages in order to add the ‘sergey-dryabzhinsky/php55’ and ‘sergey-dryabzhinsky/packages’ repository
apt-get install software-properties-common python-software-properties
Add both repositories using ‘add-apt-repository’
add-apt-repository ppa:sergey-dryabzhinsky/php55 add-apt-repository ppa:sergey-dryabzhinsky/packages
Update the package list
Install PHP 5.5 and the required PHP 5.5 packages for Orangescrum
apt-get install php55-common libapache2-mod-php55 php55-mod-curl php55-mod-gd php55-mod-mysql php55-mod-mcrypt
Enable the PHP5.5 module in the Apache web server
Restart the Apache web server
service apache2 restart
5. Install MariaDB Database Server
A database is required for running Orangescrum, so we will need to install MariaDB database server
apt-get install -y mariadb-server
6. Secure MariaDB Installation
Once the MariaDB installation is completed, run the ‘mysql_secure_installation’ script to secure the database server and set a root password
7. Create New Database
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)]> FLUSH PRIVILEGES; 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.
8. Download Orangescrum and Unpack it
Download Orangescrum to your server
Unpack it to your document root directory
unzip master.zip -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
9. Import the Orangescrum Data
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
10. Configure Orangescrum
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", "YourDomain.com"); //ex. demo.orangescrum.com define('FROM_EMAIL_NOTIFY', 'email@example.com'); //(REQUIRED) define('SUPPORT_EMAIL', 'firstname.lastname@example.org'); //(REQUIRED) From Email
and save the file.
Now just $43 .99
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@example.com DocumentRoot /var/www/html/orangescrum/ ServerName yourdomain.com ServerAlias www.yourdomain.com <Directory /var/www/html/orangescrum/> Options FollowSymLinks AllowOverride All Order allow,deny allow from all </Directory> ErrorLog /var/log/apache2/yourdomain.com-error_log CustomLog /var/log/apache2/yourdomain.com-access_log common </VirtualHost>
11. Restart and Verify the Installation
Once it is done, restart the web server for the changes to take effect
service apache2 restart
http://yourdomain.com 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 install Orangescrum on Ubuntu 16.04, if you use one of our 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 on how to install Orangescrum on Ubuntu 16.04, please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.
9 thoughts on “Install Orangescrum on Ubuntu 16.04”
Hello i follow your auto and i got :
ERROR 1045 (28000): Access denied for user ‘x2crmuser’@’localhost’ (using password: YES)
You should make sure that you entered the correct MySLQ information (login, password, database) in the ‘app/Config/database.php’ file.
I’m not sure, but I think x2crmuser is a typo.
maybe its orangescrumuser??
The post has been updated. Thanks for your feedback.
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
Yes, it should be zip instead of php. We updated the blog post.
define(“WEB_DOMAIN”, “YourDomain.com”); //ex. demo.orangescrum.com —– i don’t have any domains
define(‘FROM_EMAIL_NOTIFY’, ‘firstname.lastname@example.org’); //(REQUIRED)—- can i give my email id gmail’s??
define(‘SUPPORT_EMAIL’, ‘email@example.com’); //(REQUIRED) From Email can i give my email id -gmail’s???
This shouldn’t work… Orangescrum use CakePHP 2.x which isn’t PHP7 complient.
You give “wget https://github.com/Orangescrum/orangescrum/archive/master.zip” link, which is the latest release. What version did you use to wrote this tutorial ? I’m stuck with another version, but because of PHP7 :(
We have updated the blog post to include installation instructions for PHP 5.5 which should be supported by the CakePHP version used in Orangescrum. Please try to install Orangescrum using the new installation instructions.