How do I modify my hosts file?

Modifying your hosts file will allow you to override the DNS for a domain, on that particular machine. This can be used to test your site without the test link, prior to going live with SSL, verify an alias site works prior to DNS changes, or for other DNS related reasons. This causes your local machine only to look directly at the IP specified.

Your hosts file will need to have two entries added that will contain the IP address you want the site to resolve to and the address. Adding the below two lines for example will point and to our current PHP5-ITK ("Refreshed" PHP5) cluster:

Below is how to locate and edit the hosts file on several OS platforms. Once the proper domain information is added you will save the file and your system will begin resolving to the specified IP. Once testing is finished these entries should be removed.



Windows Vista and Windows 7

Vista and Windows 7 use User Account Control (UAC) so Notepad must be run as Administrator.

1. Click Start -> All Programs -> Accessories.

2. Right click Notepad and select Run as administrator.

3. Click Continue on the "Windows needs your permission" UAC window.

4. When Notepad opens Click File -> Open.

5. In the filename field type:


6. Click Open.

7. Make the necessary changes to the hosts file.

8. Click File -> Save to save your changes.


Windows NT/2000/XP

1. Click Start -> All Programs -> Accessories -> Notepad.

2. Click File -> Open.

3. In the filename field type:


4. Click Open.

5. Make the necessary changes to the hosts file.

6. Click File -> Save to save your changes.



1. Open a terminal window.

2. Open the hosts file in a text editor (you can substitute any text editor):

sudo nano /etc/hosts

3. Enter your password.

4. Make the necessary changes to the hosts file.

5. Press control-X (hold control and hit X), then answer y when asked if you want to save your changes.


Mac OS X 10.0 - 10.1.5

1. Open /Applications/Utilities/NetInfo Manager.

2. To allow editing the NetInfo database, click the padlock in the lower left corner of the window.

3. Enter your password and click OK.

4. In the second column of the browser view, select the node named machines. You will see entries for -DHCP-, broadcasthost, and localhost in the third column.

5. Select the localhost item in the third column.

6. Choose Duplicate from the Edit menu (the quickest way to create a new entry is to duplicate an existing one). A confirmation alert appears.

7. Click Duplicate. A new entry called localhost copy appears, and its properties are shown below the browser view.

8. Double-click the value of the ip_address property and enter the IP address of the other computer.

9. Double-click the value of the name property and enter the hostname you want for the other computer.

10. Click the serves property and choose Delete from the Edit menu.

11. Choose Save from the File menu. A confirmation alert appears.

12. Click Update this copy.

13. Repeat steps 6 through 12 for each additional host entry you wish to add.

14. Choose Quit from the NetInfo Manager menu. You do not need to restart the computer. 


Mac OS X 10.6 - 10.1.8

1. Open Applications > Utilities > Terminal.

2. Open the hosts file by typing the following in the Terminal window:

sudo nano /private/etc/hosts

Type your user password when prompted.

3. Edit the hosts file. The hosts file contains some comments (lines starting with the # symbol), as well as some default hostname mappings (e.g. – local host). Append your new mappings underneath the default mappings.

4. Save the hosts file by pressing Control+x and answering y.

5. Make your changes take effect by flushing the DNS cache with the following command:

dscacheutil -flushcache

6. New mappings should now take effect.

Was this content helpful?

© 2015 Rackspace US, Inc.

Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License

See license specifics and DISCLAIMER