Edit Your DNS Hosts File

One of the most powerful tools available to anyone working on their site during a migration is their computer’s “hosts” file. The hosts file is used to map domain names to IP addresses, and can be used as an alternative to DNS. It also allows you to specify the IP address to which a website resolves on your computer, regardless of what may be published in the site’s DNS zone file.

Why Edit Your Hosts File?

Modifying your hosts file lets you view and test a site on one server while the rest of the world continues to see the site on another. That makes it an essential tool when migrating your website. With this method, you’re able to ensure that:

  • everything on the site works as expected on the new server before you update the DNS records
  • your site’s visitors won’t be affected by any potential issues related to different server environments before you’ve had a chance to resolve them

It’s actually a very simple process. Let’s take a look at an example hosts file: localhost broadcasthost
::1 localhost ceilingsky.com www.ceilingsky.com

In this case, the first three entries are defaults used to configure the local network interface. You may have more or fewer such local entries in your hosts file; you don’t need to worry about them other than to note their presence. Any custom entries will go at the bottom of the file, and in this case you can see that I have added one custom entry to the end of the file already: ceilingsky.com www.ceilingsky.com

My custom entry specifies that any request made from my computer (via web browser or SSH, email, or FTP client) for ceilingsky.com or www.ceilingsky.com will be directed to the IP address I’ve specified: You will add your own custom entry to the end of your file using the same format.

The line for your custom entry will consist of three elements:

  • the IP address of the server to which you want the domain name to resolve on your computer
  • a tab or space
  • the domain name(s) meant to resolve to the specified IP address

If you’re migrating to a ceilingsky server, your migration technician will supply you with the line to add; you will just copy and paste it into your hosts file. If your migration involves multiple IP addresses, you will have one line for each IP address, regardless of how many domain names share it.

Note: Do not remove or modify any existing local entries in your hosts file. You will only be adding a new line or lines at the bottom of the file for testing, and then removing the lines you’ve added once testing is complete.

Step #1: Edit Your Hosts File

The location of your computer’s hosts file depends on your operating system. Because it is a protected file which must be edited with administrative privileges, the procedure for editing also varies by operating system.

  • Windows
  • Mac OS X
  • Linux


In Windows, the hosts file is located at: C:\Windows\System32\drivers\etc. You will need to edit the file with administrative privileges.

  1. First, open an elevated command prompt:
    • In Windows 8 and higher, use the keyboard shortcut Windows key + x to access the Power Users menu, then select Command Prompt (Admin).
    • In previous Windows versions:
      1. Type “command” into the search field at the bottom of the Start menu.
      2. Right-click on the cmd.exe icon.
      3. Select Run as Administrator.
  2. Enter the following command:

    notepad C:\Windows\System32\drivers\etc\hosts

    Note: There is no keyboard shortcut to paste text into the command window, but you still can copy and paste the command above by right-clicking anywhere in the command window and choosing Paste from the menu. If you prefer, you also can locate Notepad, right-click its icon to select “Run as Administrator”, then open your hosts file (at C:\Windows\System32\drivers\etc) in Notepad. With this method, you will need to change “Text Documents (*.txt)” in Notepad’s file browser to “All files” to see the hosts file, and you still will need to open a command prompt to flush your DNS cache as described in Step 4.
  3. Add the appropriate line at the end of your hosts file, then save and close the file.
  4. Finally, you will want to flush your DNS cache so that you don’t have to log out and then log back in for the changes to take effect:
    • Open an elevated command prompt as above, and enter the following command:

      ipconfig /flushdns

Mac OS X

On Mac OS X, your hosts file is located at: /private/etc/hosts. You will need administrative privileges to edit the file, which you can do manually or by appending the new entry directly from the command line.

  1. First, launch Terminal from Spotlight search (Command+Space, or click on the magnifying glass icon in your menu bar) or the Utilities folder in Applications on many versions of Mac OS X.
    • To edit the file manually:
      1. Enter the following command in Terminal:

        sudo nano /private/etc/hosts

      2. Enter your password when prompted and press Enter to authenticate and open the file.
      3. Now add the appropriate line and save the file:
        1. Use your arrow keys to navigate to the bottom of the file.
        2. Type in (or paste) the IP address and website name you intend to redirect.
        3. Press Control+O to save (Write Out) the file.
        4. Press Enter to overwrite the existing file.
        5. Finally, press Control+X to exit.
    • If you prefer to simply append the entry to the existing file, you can do so with one command, substituting your server’s IP address and domain name for the ones in this example:

      echo " test.com www.test.com" | sudo tee -a /private/etc/hosts >/dev/null

      and enter your password when prompted.

  2. While you still are in Terminal, you should flush the DNS cache so you don’t have to log out and then log back in for the changes to take effect. For the current version of Mac OS X, you can do that with this command:

    dscacheutil -flushcache; sudo killall -HUP mDNSResponder

    Note: On the first few releases of Mac OS X Yosemite (versions 10.10 through 10.10.3), the command needed to flush the cache is sudo discoveryutil mdnsflushcache; sudo discoveryutil udnsflushcaches. For version-specific instructions in older versions of Mac OS X, see How To Flush Your Local DNS cache.


On Linux, you can find the hosts file at: /etc/hosts. Depending on your distribution, you likely will need administrative privileges to edit the file.

  1. You can edit the file manually with vi, vim, or nano, or append the new entry directly from the command line.
    • To use vim, open a terminal and enter the command:

      sudo vim /etc/hosts

      followed by return, and enter your password to authenticate if prompted. After adding the new entry at the end of the file, type :wq to save and close the file.

      Note: In vim, you can press “i” or “a” to enter text insertion mode; pressing the escape key (Esc) on your keyboard returns you to command mode. 
    • If you prefer to simply append the entry to the existing file, you can do so with one command, substituting your server’s IP address and domain name for the ones in this example:

      echo " test.com www.test.com" | sudo tee -a /etc/hosts >/dev/null

      and enter your password.

  2. While you’re still in a terminal, you will want to flush your DNS cache. That command can vary widely depending on your specific distribution and version:
    • Many Ubuntu and Debian-derived distributions use: sudo service dns-clean restart.
    • Other Linux distributions using NSCD (Name Service Caching Daemon) may need to use: sudo service nscd restartsudo systemctl restart nscd.service, or nscd -I hosts.

Step #2: View the Site on its New Server

At this point, your website should resolve on your computer from the IP address specified in your hosts file instead of the IP address specified in the site’s DNS record. If you’re not seeing the site on the new server, it could be because your browser is serving a cached version of the page. In that case, you can:

  • Manually clear your browser’s cache (typically Control+Shift+Delete or Command+Shift+Delete). For browser-specific instructions, see Clearing Your Browser Cache.
  • Use a private browsing window to view the site
  • View the site in another browser
  • Log out of your computer and then log back in

If you’re uncertain whether you are seeing the new site or the old, you can confirm the IP address of the site you’re viewing using a browser add-on. There is no shortage of such extensions, most of which will display a site’s IP address right in the browser’s menu bar. For your convenience, a few are listed below:

Note: ceilingsky has no association or affiliation with any of these browser extensions or their developers and cannot guarantee compatibility or performance. They’re simply among the most commonly used tools for this purpose, and their inclusion in this list does not constitute an endorsement. Please be sure to read the notes and reviews on the individual plugin pages to determine which you prefer to use.

Step #3: Test the Site on its New Server

Now that you can see the site on its new server, you must thoroughly test it to determine whether everything works as expected. It is common to see some issues and error messages when testing a migrated site. There’s no cause for alarm — typically only minor adjustments to the server configuration, such as enabling an Apache module or adjusting a php directive, are needed to resolve them.

To ensure that all your site’s software, scripts, and plugins work correctly on the new server, be sure to:

  • Visit each link on your home page and ensure that it loads without error
  • If your site runs a CMS such as WordPress or Magento, log into the administrative area
  • If your site has a shopping cart, add an item and test your checkout process
  • Test any forms on the site
  • Create a post
  • Comment on a post
  • Upload a file

Should you notice any issues when performing the above tests:

  • Note the full URL of the page
  • Note the specific error message or problem
  • Provide that information to the person performing your migration. If ceilingsky is handling the migration, simply paste that information into your migration ticket to ensure that the proper adjustments are made as quickly as possible.
  • 1 Uživatelům pomohlo
Byla tato odpověď nápomocná?

Související články

How to Use Traceroute

Last updated June, 2019   Traceroute is an application that traces the path data takes from one...

Flush Your Local DNS Cache

If your computer has trouble reaching a certain web site or server this may be due to a corrupt...

Clear Your Browser Cache

Your browser has a local file store that contains the images, CSS, JavaScript and other files of...