icehrm/readme.md

IceHrm

IceHrm is a HRM software which enable companies of all sizes to manage HR activities properly.

• IceHrm Demo
• Feature rich version of IceHrm (IceHrmPro) is available at https://icehrm.com/purchase-icehrmpro

Getting started

The easiest way to run IceHrm is using docker

• Install docker on Mac, Windows or Linux https://docs.docker.com/get-docker/

For Linux you need to install docker compose separately here https://docs.docker.com/compose/install/

$ git clone https://github.com/gamonoid/icehrm.git
$ cd icehrm
$ docker-compose -f docker-compose-prod.yaml up -d

• Visit http://localhost:8070/ to load icehrm, that's it

You can find database and app data under icehrm/docker/production

When you want to kill the docker containers

docker-compose -f docker-compose-prod.yaml down

IceHrm Mobile App (Beta)

Setup to IceHrm App with Your Account

Useful Links

• User Guide: https://icehrm.gitbook.io/icehrm/
• IceHrm Cloud Hosting: https://icehrm.com
• IceHrm Documentation (Opensource and Commercial): http://blog.icehrm.com
• IceHrm Blog: https://icehrm.com/blog
• Purchase IceHrm Pro: https://icehrm.com/modules.php
• Report Issues: https://github.com/gamonoid/icehrm/issues
• Feature Requests: https://bitbucket.org/thilina/icehrm-opensource/issues
• Community Support: http://stackoverflow.com/search?q=icehrm
• IceHrm Opensource Blog: http://icehrm.org

Installation without Docker

• Download the latest release https://github.com/gamonoid/icehrm/releases/latest

• Copy the downloaded file to the path you want to install iCE Hrm in your server and extract.

• Create a mysql DB for and user. Grant all on iCE Hrm DB to new DB user.

• Visit iCE Hrm installation path in your browser.

• During the installation form, fill in details appropriately.

• Once the application is installed use the username = admin and password = admin to login to your system.

Note: Please rename or delete the install folder (/app/install) since it could pose a security threat to your iCE Hrm instance.

Manual Installation

Upgrade from Previous Versions to Latest Version

Refer: http://blog.icehrm.com/docs/upgrade/

Setup IceHrm Development Environment

IceHrm uses docker to setup development environment

• Clone icehrm from https://github.com/gamonoid/icehrm.git or download the source

$ git clone https://github.com/gamonoid/icehrm.git
$ cd icehrm
$ docker-compose up

• Load icehrm Development preview

http://localhost:8080

• Make some changes and the changes will be reflected on the above url

• Run e2e (cypress) tests

docker-compose -f docker-compose-testing.yaml up --exit-code-from cypress

• When you are ready to push your changes to production, make sure to build the production images

$ docker-compose -f docker-compose-prod.yaml up -d --build

• Navigate to http://clients.icehrm-open.test/dev to load icehrm from VM. (user:admin/pass:admin)

Building frontend assets

• When ever you have done a change to JavaScript or CSS files in icehrm/web you need to rebuild the frontend

• First make sure you have all the dependencies (just doing this once is enough)

$ cd icehrm/web
$ npm install
$ cd ..
$ npm install

• Then run gulp

$ gulp

• If you have only changed an admin module and you know which module it is

$ gulp admin-js --memployees