How to Install OrangeHRM on Fedora CoreOS

OrangeHRM is a web-based open-source human resources management software that streamlines HR activities for businesses. Fedora CoreOS is an operating system optimized for container deployment, automatic updates, and minimal OS management. In this tutorial, we will show you how to install OrangeHRM on the latest version of Fedora CoreOS.

Prerequisites

Before proceeding to the installation process, you will need the following:

Fedora CoreOS installed on your system
A terminal emulator
Root access or sudo privileges on the system

Step 1: Create a Project Directory

We will start by creating a project directory for OrangeHRM files. To do this, open your terminal and enter the following command:

sudo mkdir /opt/orangehrm

Step 2: Install Apache and PHP

OrangeHRM requires an HTTP server and PHP to run. We will install Apache and PHP by running the following command:

sudo rpm-ostree install httpd php php-mysqlnd php-gd php-ldap php-mbstring

This will install Apache and the latest version of PHP available with its required modules.

Step 3: Download and Extract OrangeHRM

Next, download the OrangeHRM installation package from the official website using the following command:

sudo wget https://excellmedia.dl.sourceforge.net/project/orangehrm/stable/4.4.2/orangehrm-4.4.2.zip

Now, extract the downloaded package into our project directory by running:

sudo unzip orangehrm-4.4.2.zip -d /opt/orangehrm

Step 4: Configure Apache for OrangeHRM

To configure Apache for OrangeHRM, create a new virtual host file in Apache's configuration directory /etc/httpd/conf.d. Run the following command to create the file:

sudo nano /etc/httpd/conf.d/orangehrm.conf

Add the following lines in the file:

<VirtualHost *:80>
    ServerName orangehrm.example.com
    DocumentRoot /opt/orangehrm/orangehrm-4.4.2
    <Directory /opt/orangehrm/orangehrm-4.4.2>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Replace orangehrm.example.com with your domain name or IP address.

After modifying the Apache configuration, restart the Apache HTTP server with the following command:

sudo systemctl restart httpd

Step 5: Configure SELinux

SELinux is a security mechanism in Linux that may block some system access by the webserver. So, we need to configure SELinux to allow Apache access to OrangeHRM files by running the following command:

sudo chcon -Rv --type=httpd_sys_content_t /opt/orangehrm

Step 6: Access OrangeHRM

Now that we have completed the installation and configuration steps, we can access the OrangeHRM web interface by opening a web browser and accessing http://orangehrm.example.com or http://<your server's IP address>. Fill out the required information to complete the setup process.

Congratulations! You have successfully installed OrangeHRM on Fedora CoreOS!