How to Install OrangeHRM on Void Linux

OrangeHRM is a popular open-source human resource management system that is widely used in organizations of all sizes. In this tutorial, we will guide you through the process of installing OrangeHRM on Void Linux.

Requirements

Before we proceed, make sure you have the following requirements ready:

• A working installation of Void Linux.
• Access to the command line with root privileges.
• A stable internet connection.

Step 1: Update the System

Before starting the installation process, it's essential to update your system to the latest packages available. To do so, run the following command:

xbps-install -Su

This command will update all the packages on your system to the latest version.

Step 2: Install Required Dependencies

Next, we need to install the dependencies required for OrangeHRM to operate correctly. Run the following command to install the prerequisites:

xbps-install -y apache mysql-server php php-mysql php-curl php-gd php-mbstring php-xml php-zip unzip

This command will install Apache web server, MySQL database server, PHP, and other PHP modules required for OrangeHRM.

Step 3: Download OrangeHRM

After installing the prerequisites, we need to download the latest version of OrangeHRM. You can download it from their official website by running the following command:

wget https://nchc.dl.sourceforge.net/project/orangehrm/stable/4.4.4/orangehrm-4.4.4.zip

This command will download the OrangeHRM zip file to your system.

Step 4: Unzip OrangeHRM

Once the download is complete, navigate to the directory where you downloaded the OrangeHRM zip file, and run the following command to unzip it:

unzip orangehrm-4.4.4.zip

This command will extract the contents of the zip file to a new directory named 'orangehrm-4.4.4.'

Step 5: Move OrangeHRM to Apache Web Root Directory

Next, we need to move the unzipped OrangeHRM directory to Apache's web root directory. Run the following command to move the directory:

mv orangehrm-4.4.4 /var/www/html/orangehrm

This command will move the OrangeHRM directory to Apache's web root directory, making it accessible to the web server.

Step 6: Configure MySQL

Now, we need to log in to MySQL and create a database and user for OrangeHRM. Run the following command to log in to MySQL:

mysql -u root -p

Enter the root password when prompted. Once logged in, run the following commands to create a new database and user:

CREATE DATABASE orangehrm;
CREATE USER 'orangehrmuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON orangehrm.* TO 'orangehrmuser'@'localhost';
FLUSH PRIVILEGES;

This command will create a new database named 'orangehrm,' a new user named 'orangehrmuser,' and grant all privileges to the user on the newly created database.

Step 7: Configure OrangeHRM

We are almost done. Now, we need to configure OrangeHRM to use the MySQL database we created earlier. To do so, navigate to the OrangeHRM directory by running the following command:

cd /var/www/html/orangehrm

Next, run the following command to open the configuration file in a text editor:

nano symfony/config/databases.yml

Edit the contents of the file to match the following:

dev:
  propel:
      param:
        classname: DebugPDO
        dsn: 'mysql:host=localhost;dbname=orangehrm'
        username: 'orangehrmuser'
        password: 'password'
  
prod:
  propel:
      param:
         classname: DebugPDO
         dsn: 'mysql:host=localhost;dbname=orangehrm_production'
         username: 'orangehrmuser'
         password: 'password'

Remember to replace 'orangehrmuser' and 'password' with the username and password of the MySQL user we created in Step 6.

Finally, run the following commands to set the correct permissions:

chmod -R 777 cache/
chmod -R 777 symfony/log/

This command will make the cache and log directories writable by the web server.

Step 8: Accessing OrangeHRM

That's it! Open your web browser and enter the IP address of your server or the domain name pointing to the server in the address bar. You should see the OrangeHRM login screen. Use the following credentials to log in:

• Username: admin
• Password: admin

You can change the password later in the "My Info" section.

Congratulations! You have successfully installed OrangeHRM on Void Linux. You can now begin setting up the system according to your organization's requirements.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!