OrangeHRM is very easy to install. Whether you use Windows or Linux, simply watch the video tutorial on the web-based installer, and you will have OrangeHRM running within minutes.
Get Started in 10 Minutes Using Web-Based Installer
If you already have Apache HTTP Webserver (and PHP loaded as an Apache Module) and MySQL running, then you have everything you need.
In case you do not have the requisites setup, you have two options:
Use an AMP stack which has Apache, MySQL and PHP pre-configured to work together.
If you want you can configure Apache, MySQL and PHP on your own manually. You can refer to the OrangeHRM FAQ on how to install/configure them.
AMP Stack
AMP Stack for Windows
Recommended AMP stack for Windows is XAMPP Windows.Download
Notice: Make sure you download the Installer from the Basic Package and not the upgrades, developer packs, etc.
After downloading, start installing XAMPP for Windows.
You can choose the default installation location and click ’Next‘
When asked to "Install XAMPP Servers (Apache, MySQL etc) as service?",
When asked "Install Apache 2 as service?", select Yes
When asked "Install MySQL as service?", select Yes
You may skip the other services by selecting No since they are not required for OrangeHRM
Select Yes to start the XAMPP control panel too.
Notice:
In case you use any firewall software (i.e.: Windows Firewall) and if it prompts please make sure that XAMPP services (Apache Web Server, MySQL) are exempted from the blocked list.
If you use Skype, this may result in a port conflict with Apache web-server included in XAMPP when install. Therefore make sure you re-start Windows to make sure that XAMPP services start before Skype (then Skype will go for an alternate port).
AMP Stack for Linux
Recommended AMP stack for Linux is XAMPP Linux.Download
Notice: Make sure you download complete stack (usually the biggest download out of the lot) and not the upgrades, developer packs, etc.
After downloading, install XAMPP Linux. Follow the instructions that comes with XAMPP Linux or given on the XAMPP site.
Note: You always have to manually start the stack, every time you reboot.
Notes
You will have to change the ownership of OrangeHRM files to nobody.nobody
Type the following in the shell. <orangehrm> is the path where the OrangeHRM files are located.
Ex. /opt/xampp/htdocs/orangehrm2/
$ chown -R nobody:nobody <orangehrm-2.6.3> or chown -R nobody <orangehrm-2.6.3>
Web Installation
Note: XAMPP users, the Linux stack needs to be started manually. Refer to the stack documentation.
Using a JavaScript enabled browser go to http://hostname/orangehrm2/
Above hostname is "localhost" if it is installed in the machine you are currently working on or IP address if it is remotely hosted (i.e. external to the machine you are using).
Web installation will be briefly described bellow.
Welcome Screen
It will state which version of OrangeHRM will be installed.
Click [Next] button in the Welcome screen to proceed with the installation.
License Acceptance
Here you will be provided with a copy of the GNU GENERAL PUBLIC LICENSE and to continue the installation you will have to accept the license.
If you decline simply discontinue the installation and delete all OrangeHRM files you posses.
Click [I Accept] button if you accept the terms and
conditions of the license. Then you will be taken to the next page of
the Web Installer.
System Check
Here the Web Installer will check whether the pre-requirements are available.
If
all responses are green you can safely continue. You have installed
the correct versions of the pre-requisites and configured them to work.
See below for all the color codes in a sample situation.
Click [Next] button in the System Check screen to continue.
Notes
Maximum Session Idle Time before Timeout
Maximum
Session Idle Time before Timeout is checked to ensure that users don't
get logged out within a short period such as less than 15 minutes. As
a precaution it's not possible to continue installing OrangeHRM if the session times out in less than 2 minutes.
How to Fix
You will have to change session.gc_maxlifetime in the php.ini file. (Default session.g c_maxlifetime = 1440)
Important
It is still possible that some other php application running in the same server overriding session.gc_maxlifetime value in the php.ini file at runtime. This will be the case if you are running OrangeHRM in a shared host. Workaround is available but beyond the scope of this document.
How to enable InnoDB support in MySQL
To enable "InnoDB" please open "my" (or "my.cnf") file in a text
editor and search for "skip-innodb" and add the leading "#" and restart
the MySQL database server to enable InnoDB.
ex:
.
.
.
skip-innodb
.
.
.
should read as
.
.
.
#skip-innodb
.
.
.
(in XAMPP for windows my.cnf is found in C:\xampp\mysql\bin\my.cnf)
(in XAMPP for linux my.cnf is found in /opt/lampp/etc/my.cnf)
Database Creation
Enter the relevant information about your MySQL database server and database users.
Click [Next] in Database Creation screen to continue.
Notes
Privileged Database Users and OrangeHRM Database Users
Database Server users could be assigned different rights. For the web
installer to create the OrangeHRM Database, you need to give a Database
user account details (user-name/password) with permissions CREATE,
ALTER, DROP, INSERT under the field Privileged Database User/Password.
Since OrangeHRM requires only permissions INSERT, UPDATE, SELECT and
DELETE to interact with database, the web installer could create a
separate database user account to for OrangeHRM. It is always
recommended that you create a separate user account for OrangeHRM. To
do so fill in OrangeHRM User details(username/password) as required by
you, and web-installer would create the account for you.
Note: Since the database user account details used by
OrangeHRM are stored in plain text, it would be a security threat to
have OrangeHRM use Privileged user account.
Admin User Creation
Type in the Admin Username, Password and Confirm Admin User Password.
Click [Next] button in Admin User Creation Screen to continue.
Confirmation
Confirm whether the installation details are correct and Click [Install] button in the Confirmation screen to install.
Notes
Installation will begin immediately. Once you click [install] there is no way that you can stop the installation from starting. You cannot roll back the installation as well. Click [Install] only if you are sure that you want to install with the given configuration.
Installing
Here you will be shown the progress of the installation. Once the installation is completed the [Next] button will be enabled. Click [Next] button in the Installing screen to continue.
If an error occurs during the installation the whole installation will be aborted.
Click [Clean Up Install] to go to previous pages to correct the error and restart the installation. See screenshots
Notes
If the installation is aborted you will have to either DROP the database with the name you provided in the Database Creation page if it exists or key in another name for the database.
[Skip screen shots]
Following are sample screenshots of the Installing screen:
Installation has just started.
Installation in progress.
Installation has finished successfully.
Installation has been aborted due to an error.
Registration
If you want be Up-to-Date on news about OrangeHRM,
please provide your E-mail address and a name that the e-mails should
be addressed to. We would appreciate if you register here, then we
will know how many users have successfully installed OrangeHRM.
You can also provide your comments.
If you want to receive Updates or Newsletters select the tick box [Updates/Newsletter]. Click [Register] to send the information.
If the registration is successful you can click [Login to OrangeHRM] to Login to OrangeHRM.
If you don't want to register click [No thanks!].
Notes
If the sending of registration Information fails an error message will be shown. Click [Retry] to send the details again or [Skip] to skip this step an you will not be registered.
Alistair Ross
Global IT Manager, Picsel Technologies
Picsel now use OrangeHRM to manage their entire HR platform across the UK, and we will soon be deploying it for international use. Our initial trials proved that OrangeHRM was a fantastic way to have a commercially viable HR Management platform from an Open Source model. Picsel pay OrangeHRM for support and OrangeHRM have always rise to the challenge when we have an issue or require an add-on to suit the way we do business. The OrangeHRM product has gone from strength to strength in an incredibly short amount of time and I am always excited to see what is coming up in the future.
Christopher Peckham
Chief Information Officer / Chief Security Officer
Henry Bros. Electronics
USA
HBE s use of OrangeHRM allows staff to record how much time has been spent on each job and task. After management approval, this information is loaded into our financial and payroll systems. It has greatly simplified the data entry portion of our payroll processing. Education and certification information is also stored in OrangeHRM. The system allows the company to have one source of information to query when responding to proposals and bid requests. OrangeHRM is also being interfaced with our SugarCRM and job ticketing system to further improve our time reporting process. Our overall HR and time related reporting accuracy has been greatly improved with our use of the system.
Sol Echeverria
Socia-Directora General
Factor Humano
Costa Rica
OrangeHRM es una excelente herramienta para el desarrollo de Pymes en Latinoamerica, pues nos permite gestionar los procesos de recursos humanos con mayor calidad, para generar un impacto de mayor valor agregado en el negocio
OrangeHRM is an amazing tool for the development of SMBs in Latin America, since it makes possible to have high quality human resources management, in order to provide greater value added to the business.
Hertha Gentle
HR Director
University Of Belize,
Belize
Orange HRM has helped the University of Belize drastically in facilitating work for us. Thanks to Orange HRM there is quick access to information both by employees and administrators. It facilitates the process of calculating leave for employees. It has helped also in the coherent and accurate process of vacancies and recruiting employees. The generation of reports is a wonderful job being done as there is no need for manual generation of reports. In general Orange HRM has helped the University amazingly and is continuing to help us.
Paul Mishiyama
Vice President
Information Technologies
Johnny Rockets,USA
As part of our long term strategy to combine the impressive capabilities of open source with a fresh, cost-effective approach to IT, Johnny Rockets immediately recognized the unique possibilities that OrangeHRM offers: A modern HRIS system based on open standards, providing extensibility, maintainability and the ability to truly recognize a significant ROI. This has afforded us the capability to integrate Human Resource Management easily into our existing infrastructure, leveraging many other previous efforts to streamline our business processes, and maximize employee efficiency; all while not giving up any expected modern HRIS features.
Next
Previous
