If you are using icehrm cloud please skip this.

Getting IceHrm installed only takes a few minutes. If it ever becomes a problem, please file an issue describing the issue you encountered and how we might make the process easier.

Software Requirements #

Before installing IceHrm please make sure your system supports the following requirements.

• Operating system: Dabian (8/9/10) or Ubuntu (18 LTS or 20 LTS) – Any other linux distribution should also work, but we recommend to select a long term support (LTS) release
• Web Server: Nginx (Recommended) or Apache. If you are using Windows please use WAMPP (https://bitnami.com/stack/wamp/installer) to host IceHrm
• Database: MySQL 5.7 or 8.0 ( MariaDB is not supported )
• PHP: PHP 7.0 or Higher, up to PHP v8.1
• PHP Extensions
  • Net_SMTP extension for PHP
  • php-mysql extention
    $> sudo apt-get install php-mysql
  • PHP GD library
    $> sudo apt-get install php7.0-gd

Optional Extensions #

These are optional components that could improve Icehrm performance

• Memcache

Hardware Requirements #

Installation #

• If you are installing the open-source version, download the latest release from GitHub
• If you are installing the IceHrmPro you should have received the files after purchase.
• Copy the downloaded file to the path you want to install IceHrm in your server and extract.
• Create a MySQL DB for IceHrm and a user. Grant all on IceHrm DB to the new user.
• Visit IceHrm 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.

Cron (Scheduled Task) for Notifications #

Notification cron is used to send periodic notifications. Document expiry notifications will depend on this scheduler.

To trigger the scheduler you need to run the following file

(IceHrm Root)/app/cron.php

Setting up Linux Cron #

In a Linux environment, a cron should be set up to run every 10 minutes.

This can be done by placing the following line in your crontab. Depending on your server you can edit crontab sudo vi /etc/crontab

or you can use crontab -e command

/10 * (IceHrm Root)/app/cron.php

Make sure that (IceHrm Root)/app/cron.php file is executable.

For setting up the windows scheduler please check :
– https://learn.microsoft.com/en-us/windows/win32/taskschd/task-scheduler-start-page
– https://www.ibm.com/docs/en/datacap/9.1.6?topic=application-configuring-windows-task-scheduler-automatically-run-ruleset

Configure PDF Downloads #

IceHrm uses WKHTMLTOPDF.

You can download and install the correct release for your OS here https://wkhtmltopdf.org/downloads.html

Then you should find the path to ‘wkhtmltopdf’ and update icehrm/core/config.base.php as shown below.

if(!defined('WK_HTML_PATH')){
    define('WK_HTML_PATH', '/usr/local/bin/wkhtmltopdf');
}