Manual Installation

If you encountered any issues with automated installation please follow these steps to manually configure icehrm on your server.
Download and Extract IceHrm Latest Release
1.
If you are using icehrm opensource version download it from (https://github.com/gamonoid/icehrm/releases). Make sure to download the release .zip or .gz file (e.g : icehrm_v19.0.OS.zip).
2.
If you have purchased icehrm pro, you can find installation directory inside the files you have downloaded after purchase.
3.
Extract icerm to public web directory root on your web server for now we assume it to be (/var/www/)
Creating MySQL Database
Login to your mysql installation and create a database and a user for icehrm
1
mysql> create database icehrm;
2
mysql> create user 'icehrm_user'@'localhost' identified by 'icehrm_pwd';
3
mysql> grant all on icehrm.* to 'icehrm_user'@'localhost';
Copied!
Then execute icehrm database scripts on newly created mysql database via console or phpmyadmin.
The two files you need to execute can be found in icehrm installation directory (assuming it to be /var/www/icehrm)
1.
/var/www/icehrm/scripts/icehrmdb.sql
2.
/var/www/icehrm/scripts/icehrm__master__data.sql
1
mysql> use icehrm;
2
mysql> source /var/www/icehrm/scripts/icehrmdb.sql
3
mysql> source /var/www/icehrm/scripts/icehrm_master_data.sql
Copied!
Creating Configuration File
Inside <icehrm>/app/ directory you will find:
config.sample.php
1
<?php 
2
ini_set('error_log', '_LOG_');
3
define('APP_NAME', 'Ice Framework');
4
define('FB_URL', 'Ice Framework');
5
define('TWITTER_URL', 'Ice Framework');
6
define('CLIENT_NAME', '_CLIENT_');
7
define('APP_BASE_PATH', '_APP_BASE_PATH_');
8
define('CLIENT_BASE_PATH', '_CLIENT_BASE_PATH_');
9
define('BASE_URL','_BASE_URL_');
10
define('CLIENT_BASE_URL','_CLIENTBASE_URL_');
11
define('APP_DB', '_APP_DB_');
12
define('APP_USERNAME', '_APP_USERNAME_');
13
define('APP_PASSWORD', '_APP_PASSWORD_');
14
define('APP_HOST', '_APP_HOST_');
15
define('APP_CON_STR', 'mysqli://'.APP_USERNAME.':'.APP_PASSWORD.'@'.APP_HOST.'/'.APP_DB);
16
//file upload
17
define('FILE_TYPES', 'jpg,png,jpeg');
18
define('MAX_FILE_SIZE_KB', 10 * 1024);
19
//Home Links
20
define('HOME_LINK_ADMIN', CLIENT_BASE_URL."?g=admin&n=dashboard&m=admin_Admin");
21
define('HOME_LINK_OTHERS', CLIENT_BASE_URL."?g=modules&n=dashboard&m=module_My_Account");
Copied!
Rename this file to config.php and start updating it.
You may change app name and social media urls to your company social media accounts:
1
define('APP_NAME', 'Ice Framework');
2
define('FB_URL', 'Ice Framework');
3
define('TWITTER_URL', 'Ice Framework');
4
define('CLIENT_NAME', '_CLIENT_');
Copied!
So above section can be changed to:
By default CLIENT_NAME should be app
1
define('APP_NAME', 'IceHrm - Your Company Name');
2
define('FB_URL', 'https://facebook.com/yourcompany');
3
define('TWITTER_URL', 'https://twitter.com/yourhandle');
4
define('CLIENT_NAME', 'app');
Copied!
For updating urls you need to know the absolute path of your icehrm installation and url to your icehrm installation.
For an example we assume path to icehrm is : /var/www/icehrm/ and icehrm web url to be http://your-company-domain.com/icehrm then paths and urls should be updated as below.
1
define('APP_BASE_PATH', '/var/www/icehrm/core/');
2
define('CLIENT_BASE_PATH', '/var/www/icehrm/app/');
3
define('BASE_URL','http://your-company-domain.com/icehrm/web/');
4
define('CLIENT_BASE_URL','http://your-company-domain.com/icehrm/app/');
Copied!
If you are using windows note that all the path should be specified with forward slash
e.g
1
define('APP_BASE_PATH', 'C:/xampp/htdocs/icehrm/core/');
Copied!
Then you can update the database configurations as shown below:
1
define('APP_DB', 'icehrm');
2
define('APP_USERNAME', 'icehrm_user');
3
define('APP_PASSWORD', 'icehrm_pwd');
4
define('APP_HOST', 'localhost');
Copied!
If you would like to upload files larger than 10MB you can update MAX_FILE_SIZE_KB config.

Getting Started - Previous

Installation

Next - Getting Started

Securing icehrm installation

Last modified 2yr ago

Copy link

Contents

Download and Extract IceHrm Latest Release

Creating MySQL Database

Creating Configuration File