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

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

• 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 development environment is packaged as a Vagrant box. I includes php7, nginx, phpunit and other software required for running icehrm

Preparing development VM with Vagrant

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

• Install Vagrant https://www.vagrantup.com/downloads.html

• Run vagrant up in icehrm root directory (this will download icehrm vagrant image which is ~1 GB)

~ $ vagrant up

• Run vagrant ssh to login to the Virtual machine

~ $ vagrant ssh

• Add following entries 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)

192.168.40.40   app.icehrm-open.test
192.168.40.40   clients.icehrm-open.test

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

Notes to Developers

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

~ $ cd /vagrant
~ $ gulp

Docker Setup

docker run -it -v $PWD:/e2e -w /e2e cypress/included:3.2.0

vagrant ssh -c 'cd /vagrant/core/robo; php robo.phar reset:db test; php robo.phar create:tables test; php robo.phar migrate:all test; php robo.phar execute:fixtures test'

docker-compose up --build

docker-compose -f docker-compose-testing.yaml up

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