Rewrite or Redirect URL with NGINX

May 18, 2021 misc-web nginx
This post is more than 18 months old. Since technology changes too rapidly, this content may be out of date (but that's not always the case). Please remember to verify any technical or programming information with the current release.

This is an article that originally appeared on RedirectURL, a site I built a while ago. Find out the history of that site here

With a few steps, you can create redirects using your NGINX server configuration. Let’s see how.

Locate Your NGINX Configuration File

We’re going to make our changes to the nginx.conf file. Depending on your operating system, this might be located in one of many places:

  • /etc/nginx/nginx.conf
  • /usr/local/nginx/nginx.conf
  • /usr/local/nginx/conf/nginx.conf

Note where the file is. We’ll make changes to it soon.

Configuring the Server Redirect

For this example, we’re going to stick with a very common scenario that’s very simple.

We want to redirect to with a permanent 301 HTTP code.

Writing the Rule and Placing it Properly

Open the nginx.conf file you found in the previous section. You’ll need to find the server block that matches your site’s domain name.

Inside of the server block, you can write the following:

rewrite ^/(.*)$ permanent;

Finally, you need to reload your NGINX server after the config changes. Depending on your service install and configuration, you will need to run one of these commands (depending on your operating system):

  • sudo nginx -s reload
  • sudo /usr/local/nginx/sbin -s reload
  • sudo /etc/init.d/nginx reload
Go to All Posts