- IceHrm Demo
- Feature rich version of IceHrm (IceHrmPro) is available at https://icehrm.com/purchase-icehrmpro
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 $ touch app/data/icehrm.log (or create the file manually) $ docker-compose -f docker-compose-prod.yaml up -d
- Visit http://localhost:8070/ to load icehrm
You can find database and app data under
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)
- 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.
Upgrade from Previous Versions to Latest Version
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
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
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
- If you have only changed an admin module and you know which module it is
$ gulp admin-js --memployees