How to Install OrangeHRM with Nginx on Ubuntu 24.04

Implementing OrangeHRM on Ubuntu 24.04 with Nginx provides a powerful, open-source HR management solution optimized for performance and flexibility. This guide walks you through installing and configuring OrangeHRM, a popular Human Resource Management system, using Nginx as the web server. Before starting, ensure your server has a clean Ubuntu 24.04 installation, root or sudo access, and an active internet connection. You will also need to have basic familiarity with command-line operations and server management.

What You’ll Need

Ubuntu 24.04 server with root or sudo privileges
Domain name pointed to your server’s IP (optional but recommended)
Basic knowledge of Linux command-line
SSL certificate (optional but recommended for HTTPS)

Step-by-Step

Update your system packages: Start by updating your server to ensure all packages are current.
```
sudo apt update && sudo apt upgrade -y
```

Install necessary dependencies: Install PHP, MariaDB (or MySQL), and other required packages.

sudo apt install php php-fpm php-mysql php-xml php-mbstring php-zip php-gd php-curl php-ldap mysql-server nginx unzip wget -y

Secure your MySQL installation: Run the security script and set a root password.
```
sudo mysql_secure_installation
```

Create a database and user for OrangeHRM: Log into MySQL and execute:

sudo mysql -u root -p
CREATE DATABASE orangehrm;
CREATE USER 'orangehrmuser'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON orangehrm.* TO 'orangehrmuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Download the latest OrangeHRM package: Visit the official website to get the latest version or use wget.
```
wget https://sourceforge.net/projects/orangehrm/files/latest/download -O orangehrm.zip
```
Extract OrangeHRM files: Unzip the package into your web directory.
```
sudo unzip orangehrm.zip -d /var/www/html/orangehrm
```

Set proper permissions: Ensure the web server can access the files.

sudo chown -R www-data:www-data /var/www/html/orangehrm
sudo chmod -R 755 /var/www/html/orangehrm

Create an Nginx server block: Configure Nginx to serve OrangeHRM.

sudo nano /etc/nginx/sites-available/orangehrm

Add the following configuration:

server {
    listen 80;
    server_name your_domain.com;
    root /var/www/html/orangehrm;

    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
    }

    location ~ \.ht {
        deny all;
    }
}

Save and exit the editor.

sudo ln -s /etc/nginx/sites-available/orangehrm /etc/nginx/sites-enabled/

Test and restart Nginx: Ensure the configuration is correct and reload.
```
sudo nginx -t
sudo systemctl reload nginx
```
Configure PHP settings: Adjust PHP-FPM settings if necessary for performance.
```
sudo nano /etc/php/8.1/fpm/php.ini
```
Look for and update relevant directives like memory_limit, upload_max_filesize, post_max_size, and max_execution_time.
```
sudo systemctl restart php8.1-fpm
```
Complete the installation via web browser: Navigate to http://your_domain.com or http://server_ip to access the OrangeHRM installer.
Follow the on-screen prompts to complete the setup, entering database details and admin credentials.

Common Mistakes

Forgetting to restart PHP-FPM or Nginx after configuration changes.
Incorrect file permissions leading to inability to access or execute files.
Not updating the database credentials in the configuration files.
Using the wrong PHP version path in the Nginx configuration.
Skipping the SSL setup if deploying in production, which can expose data.

Tips

Always back up your database before major updates or changes.
Consider setting up a firewall (ufw) to restrict access to only necessary ports.
Use HTTPS for secure data transmission, especially if users will access sensitive information.
Regularly update your server packages and OrangeHRM to keep security tight.
Monitor server logs for errors or suspicious activity.

Troubleshooting

Website not loading or showing errors: Check Nginx error logs at /var/log/nginx/error.log. Verify Nginx configuration syntax with sudo nginx -t. Restart Nginx if necessary.
PHP errors or blank pages: Review PHP-FPM logs at /var/log/php8.1-fpm.log. Ensure PHP modules are correctly installed and enabled.
Database connection issues: Double-check database credentials in the OrangeHRM config file, and ensure the database server is running.
Permissions errors: Confirm ownership and permissions of the OrangeHRM directory.
SSL certificate problems: Verify your SSL setup and ensure certificates are correctly installed and referenced.

Frequently Asked Questions

1. Do I need a domain name to install OrangeHRM?

No, you can access OrangeHRM via your server’s IP address, but using a domain name is recommended for easier access and SSL setup.

2. Can I install OrangeHRM without SSL?

Yes, but for security reasons, especially over the internet, it’s highly recommended to use SSL certificates to encrypt data.

3. How do I update OrangeHRM after installation?

Download the latest version, back up your database and current files, then replace the application files or follow the upgrade instructions provided by OrangeHRM.

4. Is it possible to run multiple OrangeHRM instances on the same server?

Yes, by configuring separate server blocks and databases for each instance, you can host multiple OrangeHRM deployments.

5. How do I secure my OrangeHRM installation?

Implement HTTPS with SSL, keep the system updated, restrict access with firewalls, and regularly back up your data.

6. What performance optimizations can I do?

Enable caching, optimize PHP and database settings, use a Content Delivery Network (CDN), and ensure server resources are adequate for your user load.

By following these steps carefully, you’ll have a fully functional OrangeHRM setup running on Ubuntu 24.04 with Nginx, ready to manage your human resources efficiently and securely.

How to Install OrangeHRM with Nginx on Ubuntu 24.04

How to Install OrangeHRM with Nginx on Ubuntu 24.04

What You’ll Need

Step-by-Step

Common Mistakes

Tips

Troubleshooting

Frequently Asked Questions

1. Do I need a domain name to install OrangeHRM?

2. Can I install OrangeHRM without SSL?

3. How do I update OrangeHRM after installation?

4. Is it possible to run multiple OrangeHRM instances on the same server?

5. How do I secure my OrangeHRM installation?

6. What performance optimizations can I do?

Related