How to Install IceHrm on Fedora CoreOS Latest

IceHrm is an open-source human resource management application that allows you to manage employee data, leave requests, performance management, and time tracking. Installation of IceHrm on Fedora CoreOS can be done in a few easy steps.

In this tutorial, we will look at the steps required to install IceHrm on Fedora CoreOS Latest.

Prerequisites

  • A machine running Fedora CoreOS latest version.
  • A working internet connection.
  • A minimum of 2GB RAM and 2 CPU cores.

Step 1: Install the Docker Package Manager

The first step is to install the Docker package manager. Execute the following command to install Docker:

$ sudo rpm-ostree install docker –-ignore-includes

The above command installs the Docker package without including it in the OSTree-based OS image, which is the default behavior.

After successful installation of Docker, enable docker to start at boot by executing the following command:

$ sudo systemctl enable docker
$ sudo systemctl start docker

To verify if docker is installed correctly or not, run the following command:

$ sudo docker run hello-world

Step 2: Install IceHrm

For the installation of the IceHrm application, you will have to use the docker-compose utility.

First, create a new directory to store the IceHrm configuration files:

$ mkdir icehrm
$ cd icehrm

Once you are in the IceHrm directory, you can use the following command to create a new docker-compose file:

sudo vi docker-compose.yml

Copy the following content to the docker-compose file:

version: "3"
services:
  app:
    image: icehrm/icehrm:latest
      ports:
        - 9090:443
      restart: always
      environment:
        APP_URL: https://<your server IP or domain name>
        DB_HOST: db
        DB_PORT: 3306
        DB_DATABASE: icehrm
        DB_USERNAME: root
        DB_PASSWORD: mypassword
        MAIL_DRIVER: smtp
        MAIL_HOST: <your mail server>
        MAIL_PORT: <smtp port>
        MAIL_USERNAME: <username>
        MAIL_PASSWORD: <password>
        MAIL_ENCRYPTION: ssl
      volumes:
        - /data/icehrm:/app/public/tenant_files
  db:
    image: mysql:5.7
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: <root password>
      MYSQL_DATABASE: icehrm
      MYSQL_USER: icehrm
      MYSQL_PASSWORD:<icehrm password>
    volumes:
      - icehrmdb:/var/lib/mysql
volumes:
  icehrmdb:

Save and exit the file. This docker-compose file defines an IceHrm service and the database service.

You can now run the IceHrm application by executing the following command:

sudo docker-compose up -d

This command will start the IceHrm application in detached mode.

Step 3: Access the IceHrm Application

After the installation of IceHrm, access it by opening a web browser and navigating to the IP address of your server or domain name followed by /icehrm.

For example:

https://<your server IP or domain name>/icehrm

You can then login to the IceHrm application using the default credentials:

Username: admin
Password: admin

After logging in, you can change the password and configuration settings to match your requirements.

Congratulations, you have successfully installed IceHrm on Fedora CoreOS latest version.