broadiq/orangehrm repository overview

⁠OrangeHRM Open Source Application

OrangeHRM is a comprehensive Human Resource Management (HRM) System that captures all the essential functionalities required for any enterprise. Copyright (C) 2006 OrangeHRM Inc., http://www.orangehrm.com/⁠

OrangeHRM is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

OrangeHRM is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

⁠Prerequisites

To run this application you need Docker Engine >= 1.10.0.

OrangeHRM requires access to a MySQL database.

⁠How to use this image

Running OrangeHRM with a database server is the recommended way. You can run the containers manually or install them in Kubernetes environment.

⁠Using the Docker Command Line

If you want to run the application manually using docker, these are the basic steps you need to run:

$docker run -td --name='orangehrm' \
    --rm -p 9222:80 \
    broadiq/orangehrm

⁠Fresh Install

Once docker or Kubernetes has finished installing the image, navigate to the URL and follow the installation wizard. This will install and create a new OrangeHRM database in MySQL and create initial admin credentials.

⁠Redeploy the Application

Once docker or Kubernetes has finished installing the image, navigate to the URL and click on the upgrade link. Select version 3.2 from the drop down and click procede. Then follow the remaining upgrade wizard links.

⁠Issues

⁠An internal error occurred

After the application is running and there are messages with "An internal error occurred" being shown on the screen (especially when you click on PIM or Projects), you might have an database issue. The following command will remove ONLY_FULL_GROUP_BY from mysql so that OrangeHRM can make the correct query.

mysql > SET GLOBAL sql_mode=(SELECT REPLACE(@@sql_mode,'ONLY_FULL_GROUP_BY',''));

After running the command you many need to restart the application or re-install the application.

⁠How to use this image

This image is meant to be used with BroadIQ⁠. Please go to BroadIQ and create an account if you don't have one. Then you can use BroadIQ's tools to deploy the image.