How to Install WordPress with Nginx on CentOS 7

WordPress is the most popular and widely used blogging and content management system in the world. PHP processing and MySQL database are used as a backend in WordPress. WordPress has seen incredible adoption and is a great choice for getting a Blog, Portfolio Website, webshop etc. In this tutorial, we will show you how to install WordPress with Nginx on CentOS 7 system.

Prerequisites#

We are going to use LEMP (Linux, Nginx, MySQL, and PHP) stack with Nginx as web server. So ensure that you met the following prerequisites before start installation process:

• CentOS 7 server with a non-root user with sudo privileges.
• Nginx must installed and configured, as shown in this tutorial.
• Your domain name should pointing to your server IP address.
• An SSL certificate installed for your domain. You can install a free Let’s Encrypt SSL certificate as shown in this tutorial.

Create MySQL database and Grant Permissions#

WordPress is using MySQL database to store the data. So first of all we need to create a MySQL database, MySQL user account and grant permission. If you system don’t have installed MySQL you can follow How to Install MySQL on CentOS 7 and if you want to install MariaDB then follow, How to Install MariaDB on CentOS 7 tutorials.

At first, log in to MySQL shell using below command:

mysql -u root -p

It will prompt you to enter password for the root user. You will be logged in on entering correct password.

Type the below command to create a new MySQL database for your WordPress:

CREATE DATABASE wordpress DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;

Now you have to create a new MySQL user by issuing below command:

GRANT ALL ON wordpress.* TO 'wordpressuser'@'localhost' IDENTIFIED BY 'enter-strong-password';

Need to flush the database so changes can reflact in MySQL, type:

FLUSH PRIVILEGES;

Finally, exist from MySQL shell by typing:

EXIT;

Install PHP on CentOS#

By default CentOS 7 have installed 5.4 PHP version. PHP 7.2 is recommended PHP version for WordPress. Execute the following command to Install PHP 7 and required PHP extensions:

sudo yum install epel-release yum-utils

sudo yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm

sudo yum-config-manager --enable remi-php72

sudo yum install php-cli php-fpm php-mysql php-json php-opcache php-mbstring php-xml php-gd php-curl

PHP FPM will be using Nginx as a web server so we also installed it. By default PHP FPM will run as user apache on port 9000 so we need to change the user to nginx and switch from TCP socket to Unix socket.

To make changes open the /etc/php-fpm.d/www.conf file and edit as following and remaining should keep as is:

...
user = nginx
...
group = nginx
...
listen = /run/php-fpm/www.sock
...
listen.owner = nginx
listen.group = nginx

Set the correct ownership using following command:

sudo chown -R root:nginx /var/lib/php

To take effect you should enable and start the PHP FPM service:

sudo systemctl enable php-fpm

sudo systemctl start php-fpm

Downloading and Setup WordPress#

First, navigate to /tmp directory using below command:

cd /tmp

Now download the latest WordPress setup from the WordPress download page using using below wget command:

wget https://wordpress.org/latest.tar.gz

Once the download is completed, extract the downloaded files using below command:

tar xzvf latest.tar.gz

After that, create the configuration file for WordPress using below command:

cp /tmp/wordpress/wp-config-sample.php /tmp/wordpress/wp-config.php

Then copy all the files to example.com directory using below command:

sudo cp -a /tmp/wordpress/. /var/www/example.com

You need to set the correct permissions so web server can the site’s files and directories. To change the ownership of example.com directory use following chown command:

sudo chown -R www-data:www-data /var/www/example.com

Configure Nginx#

You should have installed Nginx with SSL certificate installed on your CentOS 7 machine. We will follow the Nginx recipe from the official Nginx site to create a new server block for our WordPress instance.

Open your text editor and Create a Nginx Server Block file:

server {
    listen 80;
    server_name www.example.com example.com;

    include snippets/letsencrypt.conf;
    return 301 https://example.com$request_uri;
}

# Redirect WWW -> NON WWW
server {
    listen 443 ssl http2;
    server_name www.example.com;

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
    include snippets/ssl.conf;

    return 301 https://example.com$request_uri;
}

server {
    listen 443 ssl http2;
    server_name example.com;

    root /var/www/html/example.com;
    index index.php;

    # SSL parameters
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
    include snippets/ssl.conf;
    include snippets/letsencrypt.conf;

    # log files
    access_log /var/log/nginx/example.com.access.log;
    error_log /var/log/nginx/example.com.error.log;

    location = /favicon.ico {
        log_not_found off;
        access_log off;
    }

    location = /robots.txt {
        allow all;
        log_not_found off;
        access_log off;
    }

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

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/run/php-fpm/www.sock;
        fastcgi_index   index.php;
        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;
    }
}

Note : You should replace your real domain name with example.com and set correct SSL certificates path.

Next, you should Enable the server block by creating a symbolic link to the sites-enabled directory:

sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/

It’s recommended to check nginx syntax errors by typing:

sudo nginx -t

If there are no errors the output should look like this:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

After that restart the nginx server :

sudo systemctl restart nginx

Complete the WordPress Installation#

Now WordPress is configuration is complete and we can finish remaining installation through web interface.

To do it open your browser and type your domain name and it should show page as following:

Select language which you would like to set and click on continue button to go ahead.

After that it will show below page you just have to click on Let’s Go! button to continue.

On next page it will ask you to enter database connection details. Enter MySQL database and user details which you created previously.

Next hit on the Run the installation button to start installation process.

On next screen, You should enter name of WordPress site and set username and password for your site. Also, enter your email address and select whether you want to discourage search engines from indexing the site (It’s not recommended).

Finally, click on the Install WordPress button and once the installation is finished you will see the below screen:

Hit on Login button you will be redirected to WordPress login page. Now use the username and password which you set in previous step.

After successful login you will be redirected to the WordPress administration dashboard as following:

That’s it. You did and now you can customize your WordPress installation by installing new themes and plugins.

Conclusion#

You have successfully installed WordPress with Nginx on your CentOS 7 server.

If you have questions feel free to leave a comment below.