How Can We Help?

URLs Redirect with Apache Web Server

Table of Content

You can learn how to redirect URLs with Apache in this section. Redirecting a URL allows you to return an HTTP status code that guides the client to a specific URL, making it useful for instances where a piece of content has been transferred. Redirect is a member of the mod alias module of Apache.

Before You Begin

1. This guide assumes you have followed our Guides to Getting Started and Securing Your Server and you have installed your Apache installation already. If you have not, please refer to our Apache or LAMP stack guides.

2. You can change the configuration files for Apache in this guide so make sure you have the correct permissions to do so.

3. Update your system.

Based on the distribution of Linux, the Apache virtual host configuration files are located at various locations. CentOS 7, for example: /etc/httpd /conf.d/vhost.conf; Ubuntu 16.04: /etc/apache2/sites-available/ For example. In order to be brief, the configuration file extracts from this guide will lead you to the configuration option for Apache.

After making changes, remember to reload Apache configuration:

CentOS 7

sudo systemctl restart httpd

Ubuntu 16.04

sudo systemctl restart apache2

The Redirect Directive

You can find Redirect settings in your main Apache configuration file but we suggest that you keep them in your virtual host files or directory blocks. You can also use the Redirect statements in files with .htaccess. Here is an example of how Redirect could be used:

Apache configuration option

Redirect /username

If no reason is provided, Redirect will submit a temporary (302) status code, and the client will be told that the /user name resource has temporarily moved to http:/

No matter where they are located, Redirect statements must define the redirected resource's complete file path, following the domain name. Such statements must provide even the full URL of the new location of the site.

You may also have a claim to return a HTTP status specific to:

Apache configuration option

Redirect permanent /username http://team.abccom/~username/
Redirect temp /username
Redirect seeother /username
Redirect gone /username

  • Permanent informs the customer the tool has permanently shifted. That returns a status code of 301 HTTP.
  • Temp is the default action, which informs the client that the resource has temporarily relocated. This returns a 302 HTTP status code.
  • Seeother informs the user that the requested tool was replaced with a different one. This returns a 303 HTTP status code.
  • Gone informs the user that they have permanently removed the tool they are searching for. You don't need to define a definite URL when using this statement. That returns a status code of 410 HTTP.

The HTTP status codes can also be used as claims. Here is an example using the options with the status code:

Apache configuration option

Redirect 301 /username
Redirect 302 /username
Redirect 303 /username
Redirect 410 /username

RedirectPermanent and RedirectTemp can also execute permanent and temporary redirects, respectively:

Apache configuration option

RedirectPermanent /username/bio.html
RedirectTemp /username/bio.html

Redirects can also be achieved using the regex patterns, using RedirectMatch:

Apache configuration option

RedirectMatch (.*).jpg$$1.jpg

This match every request for a file with an extension of .jpg and replaces it with a position on a domain. The parentheses allow you to get a specific part of the request and insert it as a variable (specified by $1, $2, etc.) into the URL of the new site. For instance:

  • A request is forwarded to http:/ and to http:/
  • Re-direct a submission for http:/ to http:/

Beyond URL Redirection

Apache also helps you to edit URLs using mod rewrite, in addition to redirecting users. Although the features are identical, the key difference being that rewriting a URL requires the server returning a request other than the one received by the client, while redirecting simply returns a status code, and the client then asks for the "correct" answer.

Rewriting a request on a more realistic level does not affect the contents of the browser's address bar, and can be useful in hiding URLs with sensitive or vulnerable data.

Even though redirection helps you to quickly adjust the positions of different tools, in some cases you can find that rewriting suits your needs better. See Apache's mod rewrite documentation for more detail.


Table of Contents