WordPress Tutorial Series

Installing WordPress on Nginx: A Step-by-Step Guide for Linux Servers

Installing WordPress on Nginx: A Step-by-Step Guide for Linux Servers

—

by

startwordpress
in

Overview

This tutorial provides a complete, manual installation of WordPress on an Nginx web server. You will learn how to set up the full LEMP stack—Linux, Nginx, MySQL, and PHP-FPM—and complete the WordPress installation. This hands-on process gives you granular control over server performance and security, making it an excellent choice for developers and site owners building a high-performance WordPress site.

Why Choose Nginx for WordPress?

Nginx is a high-performance, event-driven web server known for its low memory footprint and ability to handle massive concurrent connections efficiently. For WordPress, this translates to faster page loads, better handling of traffic spikes, and improved overall server responsiveness compared to traditional setups like Apache. It excels at serving static files directly and efficiently proxies dynamic requests to PHP, creating a powerful and scalable foundation for your site.

Prerequisites Before You Begin

Before starting the installation, ensure you have the following:

  • A Linux Server: This guide uses Ubuntu 22.04/24.04 LTS or CentOS 7/Stream as examples. You need root access to install and configure software.
  • A Registered Domain Name: A domain must be pointed to your server's IP address via DNS for the Nginx server block and SSL setup.
  • Basic Terminal Knowledge: Comfort with using the command line interface (CLI) is essential.

You can prepare a clean server environment from your hosting provider's control panel. For instance, providers like RAKsmart offer VPS and dedicated servers with a clean OS install, giving you a fresh slate for this manual setup.

Step-by-Step Installation of WordPress on Nginx

Follow these steps in order to build your LEMP stack and install WordPress.

Step 1: Update System and Install Nginx

Start by updating your system's package list and installed packages to ensure you have the latest security patches.

On Ubuntu/Debian:

sudo apt update && sudo apt upgrade -y

On CentOS/RHEL:

sudo yum update -y

Next, install the Nginx web server.

Ubuntu/Debian:

sudo apt install nginx -y

CentOS/RHEL:

sudo yum install epel-release -y
sudo yum install nginx -y

After installation, start Nginx and enable it to launch on system boot:

Ubuntu/Debian:

sudo systemctl start nginx
sudo systemctl enable nginx

CentOS/RHEL:

sudo systemctl start nginx
sudo systemctl enable nginx

You can verify Nginx is running by visiting your server's IP address in a web browser. You should see the default "Welcome to nginx" page.

Step 2: Install PHP and PHP-FPM

WordPress requires PHP to process dynamic content. Nginx uses PHP-FPM (FastCGI Process Manager) to handle PHP requests.

Ubuntu/Debian:

sudo apt install php-fpm php-mysql -y

CentOS/RHEL:

sudo yum install php php-fpm php-mysqlnd -y

Now, configure PHP-FPM to listen on a Unix socket for better performance. Edit the pool configuration file:

Ubuntu/Debian:

sudo nano /etc/php/8.2/fpm/pool.d/www.conf

Find the line listen = /run/php/php8.2-fpm.sock and ensure the owner and group under listen.owner and listen.group are set to www-data.

CentOS/RHEL:

sudo nano /etc/php-fpm.d/www.conf

Find the line listen = /var/run/php-fpm/php-fpm.sock and ensure it exists.

Start and enable PHP-FPM:

Ubuntu/Debian:

sudo systemctl restart php8.2-fpm
sudo systemctl enable php8.2-fpm

CentOS/RHEL:

sudo systemctl restart php-fpm
sudo systemctl enable php-fpm

Step 3: Install and Secure MySQL/MariaDB

Install the database server.

Ubuntu/Debian:

sudo apt install mysql-server -y

CentOS/RHEL:

sudo yum install mariadb-server mariadb -y

Start and enable the database service.

Ubuntu/Debian:

sudo systemctl start mysql
sudo systemctl enable mysql

CentOS/RHEL:

sudo systemctl start mariadb
sudo systemctl enable mariadb

Run the security script to set a root password, remove anonymous users, and disable remote root login.

sudo mysql_secure_installation

Answer the prompts and set a strong root password.

Now, log into MySQL to create a database and user for WordPress:

sudo mysql -u root -p

Then execute these SQL commands, replacing the values with your desired ones:

CREATE DATABASE wordpress_db;
CREATE USER 'wp_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON wordpress_db.* TO 'wp_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Step 4: Configure Nginx Server Block for WordPress

Create a new server block configuration file to tell Nginx how to serve your WordPress site.

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

Paste the following configuration, adjusting your_domain:

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

 index index.php index.html;

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

 location ~ \.php$ {
 include snippets/fastcgi-php.conf;
 fastcgi_pass unix:/var/run/php/php8.2-fpm.sock; # Verify your PHP-FPM socket path
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 include fastcgi_params;
 }

 location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
 expires max;
 log_not_found off;
 }

 location ~ /\.ht {
 deny all;
 }
}

Enable this configuration by creating a symlink:

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

Remove the default configuration to avoid conflicts:

sudo rm /etc/nginx/sites-enabled/default

Test the Nginx configuration for syntax errors:

sudo nginx -t

If the test is successful, reload Nginx to apply changes:

sudo systemctl reload nginx

Step 5: Set Directory Permissions and Download WordPress

Create the web root directory and set correct ownership.

sudo mkdir -p /var/www/your_domain
sudo chown -R www-data:www-data /var/www/your_domain

Navigate to the temporary directory and download the latest version of WordPress:

cd /tmp
wget
tar -xzvf latest.tar.gz

Move the WordPress files into your web root directory:

sudo mv wordpress/* /var/www/your_domain/

Set the correct permissions for the files and directories:

sudo find /var/www/your_domain -type d -exec chmod 755 {} \;
sudo find /var/www/your_domain -type f -exec chmod 644 {} \;

Step 6: Complete the WordPress Installation via Browser

Open your web browser and navigate to your domain name (e.g., `). You will see the WordPress installation screen.

  1. Click "Submit" and then "Run the installation".
  2. Enter your site information: Site Title, Username, Password, and your Email.
  3. Click "Install WordPress".

You will be logged into the WordPress dashboard. Your site is now live!

Quick Reference: Installation Commands by Linux Distribution

The following table summarizes the key installation commands for each step, helping you quickly reference the correct commands for your server's OS.

Step Ubuntu/Debian CentOS/RHEL
Update System sudo apt update && sudo apt upgrade -y sudo yum update -y
Install Nginx sudo apt install nginx -y sudo yum install epel-release -y<br>sudo yum install nginx -y
Install PHP sudo apt install php-fpm php-mysql -y sudo yum install php php-fpm php-mysqlnd -y
Install Database sudo apt install mysql-server -y sudo yum install mariadb-server mariadb -y
Start Services sudo systemctl start nginx<br>sudo systemctl start php8.2-fpm<br>sudo systemctl start mysql sudo systemctl start nginx<br>sudo systemctl start php-fpm<br>sudo systemctl start mariadb

Decision Framework: Managed vs. Manual Nginx Installation

Choosing how to set up your server depends on your technical skill and control requirements. Use this checklist to decide.

Choose a Managed Solution or Control Panel if:

  • You want a graphical interface for server management.
  • You prefer automated updates and security patches for the server stack.
  • You need to host multiple sites with easy domain/subdomain management.
  • You value pre-configured, optimized environments without manual tuning.

Choose a Manual Nginx Installation (This Guide) if:

  • You require granular control over every aspect of the server configuration.
  • You are optimizing for specific performance metrics and a minimal resource footprint.
  • You want to learn the inner workings of a LEMP stack.
  • You are managing a single, critical application where precise configuration is key.

Common Challenges and Troubleshooting

  • "403 Forbidden" Error: This is a directory permission issue. Ensure the Nginx user (www-data or nginx) owns the WordPress directory and that the directory has 755 permissions and files have 644 permissions.
  • "502 Bad Gateway" Error: This typically means Nginx cannot communicate with PHP-FPM. Verify that PHP-FPM is running (sudo systemctl status php-fpm) and that the socket path in your Nginx configuration matches the one in your PHP-FPM pool configuration.
  • Connection Errors to Database: Double-check the database name, username, password, and that the user has privileges on the database. Ensure the database server is running.
  • SELinux Issues (CentOS/RHEL): If files aren't accessible, SELinux might be blocking Nginx. You can temporarily set it to permissive mode (sudo setenforce 0) to test, then restore permissions with sudo restorecon -Rv /var/www/your_domain before setting it back to enforcing.
  • Package Manager Errors: On CentOS/RHEL, if you encounter "Not enough cached data to install" errors, you may need to replace the yum repository. See this guide on resolving yum cache errors for a solution.

Frequently Asked Questions (FAQ)

Can I use Nginx with WordPress on a shared hosting plan?

Most shared hosting plans are configured for Apache by default and do not provide the necessary root access to install and configure Nginx from scratch. This manual installation method is intended for Virtual Private Servers (VPS), cloud servers, or dedicated servers where you have full administrative control over the environment.

Is Nginx significantly faster than Apache for WordPress?

Nginx often provides superior performance in benchmarks, especially for serving static content and handling high numbers of concurrent connections due to its asynchronous, event-driven architecture. For WordPress, which generates dynamic PHP content, the key performance gain comes from Nginx's efficient handling of static files and its proxying of PHP requests to PHP-FPM. The actual performance difference can vary based on server configuration and traffic patterns, but Nginx is widely considered a more efficient choice for high-traffic sites.

Do I need to configure SSL/HTTPS after this installation?

Yes, absolutely. This guide installs a basic HTTP setup. For security and SEO, you must configure an SSL certificate. You can obtain a free one from Let's Encrypt using Certbot. After installation, you would add another server block in Nginx to listen on port 443 (SSL) and point to your certificate files, then redirect all HTTP traffic to HTTPS.

How do I set up WordPress Multisite with this Nginx configuration?

Setting up WordPress Multisite on Nginx requires additional configuration. You will need to add a wildcard subdomain server_name in your Nginx configuration and update the try_files directive to handle subdirectory or subdomain routing correctly. It is an advanced setup that modifies the base server block.

Can I use this same Nginx configuration to install multiple WordPress sites on one server?

Yes, by creating a separate server block configuration file for each additional domain. You would duplicate your configuration file in /etc/nginx/sites-available/, change the server_name and root directives to point to a new directory for the second site, enable it with a symlink, and reload Nginx. Each site needs its own database and WordPress installation.

Conclusion

You have successfully installed WordPress on a Nginx server by manually assembling a LEMP stack. This foundation gives you exceptional control over your website's performance and security configuration. Remember to keep your server's operating system, Nginx, PHP, MySQL, and WordPress installation updated to protect against vulnerabilities.

For a powerful and reliable server to build on, consider a VPS or dedicated server that provides a clean, root-access environment. This allows you to implement precise configurations like the one in this guide. You can explore hosting options that provide this level of control, such as those offered by RAKsmart, to find a suitable starting point for your high-performance WordPress site.