Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.

Orangescrum is a free, open source, flexible project management web application written using CakePHP.


* Apache with `mod_rewrite`
	* Enable curl in php.ini
	* Change the 'post_max_size' and `upload_max_filesize` to 200Mb in php.ini
* PHP 5.6 or PHP 7.0, 7.1, 7.2
* MySQL 4.1 or higher
	* If STRICT mode is On, turn it Off.


* Extract the archive. Upload the extracted folder(orangescrum-master) to your working directory.
* Provide proper write permission to "app/Config", "app/tmp" and "app/webroot" folders and their sub-folders.
Ex. chmod -R 0777 app/Config, chmod -R 0777 app/tmp, chmod -R 0777 app/webroot
You can change the write permission of "app/Config" folder after installation procedure is completed.
* Create a new MySQL database named "orangescrum"(`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` - 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]
  * `app/Config/constants.php` - Provide your valid SMTP_UNAME and SMTP_PWORD. For SMTP email sending you can use(Only one at a time) either Gmail or Sendgrid or Mandrill. By default we are assuming that you are using Gmail, so Gmail SMTP configuration section is uncommented. If you are using Sendgrid or Mandrill just comment out the Gmail section and uncomment the Sendgrid or Mandrill configuration section as per your requirement. [Required]
  * `app/Config/constants.php` - Update the FROM_EMAIL_NOTIFY and SUPPORT_EMAIL [Required]
* Run the application as from your browser and start using Orangescrum

For more information please visit below link:

How to Git

* Fork the project from GitHub if you are interested in contributing, or you can simply watch its progress.
* To contribute, clone the repository to your system/working directory
	* Do the require changes to add some features or plug-ins on your local system
	* Do proper testing(including UI) and make sure that the changes are working properly
	* Commit/Push the code to your repository
	* Send a Pull request to Orangescrum git repository