Skip to content
Branch: master
Go to file
Code

Latest commit

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
app
 
 
 
 
 
 
 
 
 
 
 
 
web
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

readme.md

IceHrm

Build Status

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

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

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

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
You can’t perform that action at this time.