In category: ← Human Resources Management (HRM)

About IceHrm

IceHrm employee management system allows companies to centralize confidential employee information.

Github stats:

Commits: 469
460
330
Latest commit: Feb 13, 2023

Deploy this app to Linode with a free $100 credit!

Languages/Platforms/Technologies:

Lincenses:

Apache-2.0

More about IceHrm

IceHrm

IceHrm is an HRM software which enable companies to manage employee details and HR workflows.

Checkout IceHrm without installing: IceHrm Demo
Get a Mananged IceHrm Installation: IceHrm Cloud
Self Host a Feature Rich Version of IceHrm: IceHrmPro

Installation

Using Docker

Install docker on Mac, Windows or Linux https://docs.docker.com/get-docker/
Download the latest version of IceHrm and extract it.
Alternatively you can cone the repo git clone https://github.com/gamonoid/icehrm.git
```
cd icehrm
npm run setup
npm run docker:build
npm run docker:start
```

Visit http://localhost:3128/ and login using admin as username and password.
Visit http://localhost:3130/ to access phpmyadmin.
All user uploaded files are stored under icehrm/docker/production/app_data

Installation (without docker)

Please check Installation guide.

Upgrade from Previous Versions

Refer: https://icehrm.com/explore/docs/upgrade-icehrmpro/

Setup Development Environment

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

- Visit http://localhost:9080/ and login using admin as username and password. - Watch this for more detailed instructions: https://www.youtube.com/watch?v=sz8OV_ON6S8

Extend IceHrm with custom Extensions

Inorder to create an admin extension run
```
php ice create:extension sample admin
```

Refresh IceHrm to see a new menu item called Sample Admin
The extension code can br found under icehrm/extensions/sample/admin
Refer: https://icehrm.com/explore/docs/extensions/ for more details.

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
```
Build assets during development
```
gulp clean
gulp
```
Build assets for production
```
gulp clean
gulp --eprod
```
Build extensions
```
gulp ejs --xextension_name/admin
```

Debugging code with psysh

You can run psysh inside the icehrm web docker container to manually debug the code. - Start Psysh console

docker compose up -d
docker exec -it icehrm-icehrm-1 /bin/sh
./psysh -c ./.config/psysh/config.php

This will open a psysh console. You can instantiate any IceHrm class and debug it. Here is an example of creating an employee object and loading an employee from the database.

$emp = new \Employees\Common\Model\Employee();
$emp->Load('id = ?',[1]);
var_dump($emp);

Running tests (Docker)

Run e2e (cypress) tests

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

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

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
```