Skip to content


How-to Guides

Technical References

Domains & TLS /

Managing a hosts file

Modifying a hosts file allows a site to be tested with a different domain before the global DNS system has been modified or updated. This modification only affects a user’s local computer, and will need to repeated on any other devices that are used for testing.

A hosts file consists of IP addresses listed against domains. For example:

In the above example, and are modified to point at, a VIP IP address.

To determine the IP address for a VIP application, run the command host against an application’s convenience domain. For example:

$ host has address has address abcd:efgh:ijkl::c000:1234

All modern operating systems make use of a hosts file, but the process for modifying the file varies slightly for each system.


A popular app for managing the hosts file among Mac users is Gas Mask.

  1. After downloading Gas Mask, open the app and locate your hosts file.
  2. Make the necessary changes to the file.
  3. Save those changes. You may be prompted for your user password.

Windows (8 & 10)

  1. Press the Windows key.
  2. Type Notepad in the search field.
  3. In the search results, right-click Notepad and select Run as administrator.
  4. From Notepad, open the following file: c:\Windows\System32\Drivers\etc\hosts .
  5. Make the necessary changes to the file and save it.


  1. Open a Terminal window.
  2. Enter the following command to open the hosts file in a text editor: sudo nano /etc/hosts. You will be prompted for your root password.
  3. Make the necessary changes to the file.
  4. Press Control-X to save.

If the changes are not reflected immediately, clear your browser cache and try visiting the site again. Remember to revert any changes you have made once you have finished testing.

Web-based host file management

  1. Go to .
  2. Input the IP address found in your VIP Dashboard for the server address, and your final domain as the website name, then hit Get my testing URL .

Note that the testing URL will display differently from your final domain URL, but it will be reflecting the site as if it were hosted with VIP. You will still be able to login to the WP Admin and view the site prior to pointing the domain’s DNS to VIP.

Last updated: December 29, 2021