How to Set Up the htaccess File on Apache
Updated by Linode Contributed by Christopher Piccini
The purpose of this guide is to show you how to set up htaccess configuration (.htaccess) for Apache. The guide will cover topics relating to handling website file structure permissions, redirects, and IP address restrictions.
Before You Begin
Familiarize yourself with our Getting Started guide and complete the steps for setting your Linode’s hostname and timezone.
This guide will use
sudowherever possible. Complete the sections of our Securing Your Server to create a standard user account, harden SSH access and remove unnecessary network services.
Update your system:
sudo apt-get update && sudo apt-get upgrade
Complete the Apache section in the Install a Lamp Stack to install Apache on your Linode.
NoteThroughout this guide, replace each instance of
testuserwith your custom user account. Replace each occurrence of
example.comwith the IP address or Fully Qualified Domain Name (FQDN) of your Linode.
What is .htaccess
.htaccess is a configuration file for the Apache web server. It’s an extremely powerful tool that can be used to modify the Apache configuration without needing to edit the Apache configuration files. The following sections describe how to create this configuration and use it to restrict directory listings and IP addresses, and to handle redirects.
By default, .htaccess isn’t available. To enable it you will need to edit the configuration file.
Use a text editor to open your configuration file:
sudo nano /etc/apache2/sites-available/example.com.conf
After the VirtualHost block () add:
1 2 3 4 5 6 7
.... </VirtualHost> <Directory /var/www/html/example.com/public_html> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory>
Save the file, then restart apache:
sudo service apache2 restart
Restrict Directory Listings
By default, someone visiting your website can view the directory and file structure, and gain access to files on the web server. It’s best practice to restrict directory access, so that a visitor to example.com would have to be familiar with files on the server in order to see them. One way you can restrict this is through .htaccess.
CMS systems such as WordPress create .htaccess configurations by default. This guide assumes that no .htaccess file exists, so you will have to create one manually. Navigate to your site’s root directory:
Create an .htaccess file:
Now if you navigate to your site, you will see a Forbidden message. You will have to specifically indicate the file or directory you would like to see.
This section will guide you through restricting specific IPs from accessing your site. This is useful if you want to block certain visitors from visiting your site. You may also set this up to prevent certain IPs from accessing certain sections of your site.
NoteSubdirectories can inherit settings from .htaccess files in their parent directories if they’re not overridden by a separate .htaccess file in the subdirectory. The examples in this guide will continue to work with an .htaccess file in the project’s root directory. You should carefully consider in which directory different .htaccess directives should be placed.
Create or edit the .htaccess file located at the directory where Apache will host the website:
cd /var/www/html/example.com/public_html/ sudo nano .htaccess
Options -Indexesline from the previous section (if applicable) and add the following lines to block the target IP addresses:
1 2 3 4 5 6 7
order allow,deny # This will deny the IP 22.214.171.124 deny from 126.96.36.199 # This will deny all IP's from 188.8.131.52 through 184.108.40.206 deny from 172.15.23
Create or edit the .htaccess file located in the web directory where you want this setting to be applied.
Add the following lines to deny all IPs except for the specific IP and pool of IPs mentioned in the command:
1 2 3 4 5 6 7 8 9 10
order deny,allow # Denies all IP's Deny from all # This will allow the IP 220.127.116.11 allow from 18.104.22.168 # This will allow all IP's from 22.214.171.124 through 126.96.36.199 allow from 172.15.23
You can redirect traffic using .htaccess configuration. In the below example, you’ll update the .htaccess file for the root directory of your website to redirect a visitor to
http://example.com/test2/index.html if they try to visit
Create a test html file to redirect to:
mkdir test1 sudo touch test1/index.html
Add some basic content to the test html file:
1 2 3 4 5 6
<!doctype html> <html> <body> This is the html file in test1. </body> </html>
Open the .htaccess file in your project’s root directory. Remove all existing configurations in this file and add the following line:
Redirect 301 /main.html /test1/index.html
The first parameter after the ‘Redirect’ command is the HTTP status code. Specifying a status code is helpful for letting the browser know that the page has been moved to a new location. If you leave this parameter blank, it defaults to a 302 code indicating that the redirect is temporary. Specifying 301 makes it clear that the page at the requested location has permanently moved to a new location.
The next parameter is the Unix path to the file that is requested in the URL. This parameter requires that it is a Unix path and not a URL. The path should be the location of the .htaccess file where the redirect configuration is set up. The final parameter indicates where you want the visitor to be redirected. In this case, the traffic is being redirected to
/test2/index.html; for this second parameter a Unix path or HTTP URL is acceptable.
- Navigate to
example.com/main.htmlin a browser. You should see the url redirect to
example.com/test1/index.htmlin the address bar, and your test html file should be displayed.
Set the 404 Error Page
When a visitor attempts to access a page or resource that doesn’t exist (for example by following a broken link or typing an incorrect URL,) the server will respond with a 404 error code. It is important that users receive feedback explaining the error. By default, Apache will display an error page in the event of a 404 error. However, most sites provide a customized error page. You can use .htaccess settings to let Apache know what error page you would like displayed whenever a user attempts to access a nonexistent page.
This will redirect all requests for nonexistent documents to a page in the project root directory called `404.html. Open the .htaccess file and add the following line:
ErrorDocument 404 /404.html
1 2 3 4 5 6
<!doctype html> <html> <body> 404 Error: Page not found </body> </html>
In a browser, navigate to a page that does not exist, such as
www.example.com/doesnotexist.html. The 404 message should be displayed.
You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.
Join our Community
This guide is published under a CC BY-ND 4.0 license.