Code Quality Rank: L1
Programming language: JavaScript
License: GNU General Public License v3.0 or later
Tags: Human Recources Management (HRM)    
Latest version: v28.2.0.OS

IceHrm alternatives and similar software solutions

Based on the "Human Recources Management (HRM)" category.
Alternatively, view IceHrm alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of IceHrm or a related project?

Add another 'Human Recources Management (HRM)' Software solution



Build Status

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

[](docs/images/icehrm-employee-list.png)      [](docs/images/icehrm-dashboard.png)

Getting started

The easiest way to run IceHrm is using 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
$ touch app/data/icehrm.log (or create the file manually)
$ docker-compose -f docker-compose-prod.yaml up -d

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

For setting up your development environment watch https://www.youtube.com/watch?v=sz8OV_ON6S8

Refer docker documentation for best practices

IceHrm Mobile App (Beta)

Setup to IceHrm App with Your Account

Useful Links

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 (Docker)

IceHrm uses docker to setup development environment

$ git clone https://github.com/gamonoid/icehrm.git
$ cd icehrm
$ docker-compose up
  • Navigate to http://localhost:8080 to load icehrm. (user:admin/pass:admin)

  • 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

Setup IceHrm Development Environment (Vagrant)

IceHrm development environment is packaged as a Vagrant box. I includes php7.3, nginx, phpunit and other software required for running icehrm

Preparing development VM with Vagrant

~ $ vagrant up
  • Run vagrant ssh to login to the Virtual machine
~ $ vagrant ssh
~ $ sudo service nginx restart
  • Add following entry to the end of the host file to map icehrm domains to VagrantBox (on MacOS and Linux this is /etc/hosts | on windows this is Windows\System32\Drivers\etc\hosts)   icehrm.os
  • Navigate to http://icehrm.os to load icehrm from Vagrant. (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
  • For production build use

    $ gulp --eprod