This site utilizes JavaScript to function correctly. Looks like it's disabled on your browser. Please enable it for your best experience.

For instructions on enabling JavaScript, click here

Skip to main content

Just Host Web Hosting Help

htaccess Tutorial

Summary

In this tutorial you will find out about the .htaccess file and the power it has to improve your website. Just Host supports .htaccess files however as a customer you are responsible for what is in this file and how it changes your site.

Creating a .htaccess File

You can create a .htaccess file on your local computer or on the server.

On your computer:

Windows: Using Notepad save the file as .htaccess

Mac OS X: Using TextEdit save the file as ".htaccess"
Note: If you save the file as .htaccess it will be hidden and you will not be able to see it in the Finder.

Using your preferred FTP client upload the file to the server. The .htaccess file will need to be in the folder where your site is located, typically the public_html folder.

On the server

  1. Login to your cPanel Account
  2. Click the File Manager icon, located in the Files section.
  3. From the File Manger popup choose "Choose Hidden Files (dotfiles)."
    Note: If you do not see this popup you will need to click the "reset all interface settings" link at the bottom of the cPanel page.
  4. From the File Manager popup choose the folder you would like to open, most often the "Web Root (public_html/www)"
  5. Click the Go button.
    Note: If you are in the File Manager already you can add &showhidden=1 to the end of the URL.
  6. Click the New File icon to create a new file and name it .htaccess

Alternative Index Files

You may not always want to use index.htm or index.html as your index file for a directory, for example if you are using PHP files in your site, you may want index.php to be the index file for a directory. You are not limited to 'index' files though. Using .htaccess you can set foofoo.blah to be your index file if you want to!

Alternate index files are entered in a list. The server will work from left to right, checking to see if each file exists, if none of them exist it will display a directory listing (unless, of course, you have turned this off).

DirectoryIndex index.php index.php3 messagebrd.pl index.html index.htm

Custom Error Pages

You can customize your own, personal error pages (for example when a file is not found) instead of using Just Host's error pages or not having an error page. This will make your site seem much more professional.

You can use custom error pages for any error as long as you know its number (like 404 for page not found) by adding the following to your .htaccess file:

ErrorDocument errornumber /file.html

For example if I had the file notfound.html in the root directory of my site and I wanted to use it for a 404 error I would use:

ErrorDocument 404 /notfound.html
If the error page is not in the root directory of your site, you can enter the path to the file:
ErrorDocument 500 /errorpages/500.html
These are some of the most common errors:
            401 - Authorization Required
            400 - Bad request
            403 - Forbidden
            500 - Internal Server Error
            404 - Wrong page
            

Stop a Directory Index From Being Shown

Sometimes, for one reason or another, you will have no index file in your directory. This will, of course, mean that if someone types the directory name into their browser, a full listing of all the files in that directory will be shown. This could be a security risk for your site.

To prevent against this (without creating lots of new 'index' files, you can enter a command into your .htaccess file to stop the directory list from being shown:

# disable directory browsing
            
            Options ExecCGI Includes IncludesNOEXEC SymLinksIfOwnerMatch -Indexes
            
            # enable directory browsing
            Options All +Indexes

Deny/Allow Certain IP Addresses

To only allow people with specific IP addresses to access your site (for example, only allowing people using a particular network to get into a certain directory) or you may want to ban certain IP addresses (for example, keeping disruptive members out of your message boards).This will only work if you know the IP addresses you would like to ban.

Please keep in mind that most ISP's use dynamic IP addresses, so this is not always the best way to limit/grant access.

Block an IP Address

#Deny List
            
            order allow,deny
            deny from 123.123.123.123 #specify a specific address
            deny from 123.123.123.123/30 #specify a subnet range
            deny from 123.123.* #specify an IP address wildcard
            allow from all

Allow only Certain IP Addresses

#Allow List
            
            order deny,allow
            allow from 123.123.123.123 #specify a specific address
            allow from 123.123.123.123/30 #specify a subnet range
            allow from 123.123.* #specify an IP address wildcard
            deny from all
            
Note: This will still allow scripts to use the files in the directory.

Redirection

There is a tool in the cPanel that can create the Redirects for you, please see How to create a Redirect

Redirect from a specific file to a new file

Example:

Redirect /redirect_from.html http://www.newsite.com/folder/redirect_to.html

In the above example, a file in the root directory called redirect_example.html is redirected to the URL http://www.newsite.com/folder/redirect_example.html
If the old file were in a subdirectory then you could use:

/subdirectory/redirect_from.html

WildCard Redirect / Redirecting from one folder to a new folder

Redirect /redirect_from http://www.newsite.com/redirect_to

Now any request to your site below /olddirectory will be redirected to the new site, with the extra information in the URL added on, for example if someone typed in:

http://www.example.com/redirect_from/images/image.gif

They would be redirected to:

http://www.newsite.com/redirect_to/images/image.gif

Redirecting (URL Rewriting) with Joomla

To enable URL Rewriting in Joomla you will need to copy and paste the following code into your .htaccess file.

            # For security reasons, Option followsymlinks cannot be overridden.
            #Options +FollowSymLinks
            Options +SymLinksIfOwnerMatch
            

Password Protection

One of the many uses of the .htaccess is being able to reliably password protect directories on websites.
Note: If you would like to use the cPanel tool to password protect your folders please see our article: Password Protect a folder on your website

The .htaccess File

Adding password protection to a directory using .htaccess takes two stages. The first part is to add the appropriate lines to your .htaccess file in the directory you would like to protect. Everything below this directory will be password protected:

AuthName "Section Name"
            AuthType Basic
            AuthUserFile /home/username/.htpasswds
            Require valid-user 

There are a few parts of this which you will need to change for your site. You should replace "Section Name" with the name of the part of the site you are protecting e.g. "Members Area".

The /home/username/.htpasswds should be changed to reflect the full server path to the .htpasswds file (more on this later). If you do not know what the full path to your webspace is, check your Just Host cPanel. Look on the left "stats" column of the cPanel.

The .htpasswds File

Password protecting a directory takes a little more work than any of the other .htaccess functions because you must also create a file to contain the usernames and passwords which are allowed to access the site. These should be placed in a file which (by default) should be called .htpasswd. This can be placed anywhere within you website (as the passwords are encrypted) but it is advisable to store it outside the web root (in your home directory) so that it is impossible to access it from the web.

Entering Usernames And Passwords

Once you have created your .htpasswd file (you can do this in a standard text editor) you must enter the usernames and passwords to access the site. They should be entered as follows:

username:password

Where the password is the encrypted format of the password. There is a good username/password service at the KxS site which will allow you to enter the username and password and will output it in the correct format.

For multiple users, just add extra lines to your .htpasswd file in the same format as the first.

Accessing The Site

When you try to access a site which has been protected by .htaccess your browser will pop up a standard username/password dialog box. Alternatively you can send the username and password (unencrypted) in the URL as follows:

            http://username:password@www.website.com/directory/ 
            
Knowledgebase Article 2,081,227 views bookmark tags: htaccess tips tricks


Was this resource helpful?

Did this resolve your issue?


Please add any other comments or suggestions about this content:





Recommended Help Content

Explains how to edit the .htaccess
Knowledgebase Article 365,830 views tags: htaccess

Versatile and robust, WordPress is a favorite among applications and content management systems. This article provides nine tips for working in WordPress.
Knowledgebase Article 81,542 views tags: guide tips tricks wordpress wp

How do I perform a URL redirect/rewrite using the .htaccess file?
Knowledgebase Article 1,933,762 views tags: htaccess redirect rewrite url

Related Help Content

How to force https on entire website.
Knowledgebase Article 377,805 views tags: htaccess ssl website

Short tutorial on how to set file and user Permissions in cPanel.
Knowledgebase Article 306,490 views tags: file permission permissions rights

How to run CGI scripts for Addon domains.
Knowledgebase Article 231,453 views tags: cgi htaccess

This article explains how to find the database in use by a WordPress site.
Knowledgebase Article 328,097 views tags: database find wordpress

The hosts file is a plain text file that allows you to set IP Addresses for a domain on your computer. This may override authoritative DNS.
Knowledgebase Article 112,308 views tags: admin development dns file hosts ip test

How do I make a sub directory (or sub folder) act as the public_html for your main domain?
Knowledgebase Article 1,095,634 views tags: Drupal domain htaccess joomla wordpress

Preventing bandwidth theft using the mod rewrite engine and .htaccess
Knowledgebase Article 207,084 views tags: htaccess rewrite

This article will explain how to utilize GZip through the file manager.
Knowledgebase Article 229,393 views tags: archive compress compression decompress file gzip management zip

** Google ad credits are only available to customers in the United States, Canada, and the United Kingdom at this time.

¹ VAT (Value Added Tax) is not included in our advertised price and will be charged separately and itemized on invoices and billing information. Standard VAT rates based on EU Member State regulations may apply. Learn more.