{"id":3395,"date":"2014-07-09T23:52:34","date_gmt":"2014-07-10T04:52:34","guid":{"rendered":"http:\/\/wpengine.wpengine.com\/?post_type=support&p=3395"},"modified":"2026-01-14T05:54:24","modified_gmt":"2026-01-14T11:54:24","slug":"emulate-dns-change-with-the-hosts-file-trick","status":"publish","type":"support","link":"https:\/\/wpengine.com\/support\/emulate-dns-change-with-the-hosts-file-trick\/","title":{"rendered":"Emulate DNS Locally with the Hosts File Trick"},"content":{"rendered":"

NOTICE<\/p><\/div>

\n

The hosts file trick works with the WP Engine legacy network<\/a> by default. The hosts file trick may work with the Advanced Network<\/a> or Global Edge Security<\/a> networks if the domain has already been pre-verified<\/a> by Cloudflare.<\/p>\n<\/div><\/div>\n\n\n\n

\n\n\n\n

Did you know you can test your site on WP Engine after migrating<\/a> without<\/em> changing your DNS, just by editing a file on your computer?<\/p>\n\n\n\n

When you visit a website your computer saves the server IP address of the domain in the \u201chosts file\u201d. This speeds up the connection time the next time you request the website from that computer, because it already knows where to look.<\/p>\n\n\n\n

By modifying this file, you can trick your local computer into thinking that a domain lives at a different<\/em> IP address than is actually configured with the DNS host. Best of all, the change is local to your machine only. Meaning no one sees the change but you, and it can be reverted just as easily once you\u2019re done testing.<\/p>\n\n\n\n\n\n<\/a>\n\n\n\n

\n\n\n\n

Locate WP Engine IP<\/h2>\n\n\n\n

In order to point your domain to WP Engine on your local machine, you will need to know your WP Engine IP address. To find your IP address:<\/p>\n\n\n\n

    \n
  1. Log in to the User Portal<\/a><\/li>\n\n\n\n
  2. Select the environment<\/strong> name<\/strong><\/li>\n\n\n\n
  3. Click Domains<\/strong><\/li>\n\n\n\n
  4. Next to the domain, open the three dot menu icon<\/strong><\/li>\n\n\n\n
  5. Click View DNS details<\/strong><\/li>\n<\/ol>\n\n\n\n

    WP Engine provides two IP addresses. When testing with the hosts file either IP shown may be used.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n
    \n\n\n\n

    Edit Hosts File<\/h2>\n\n\n\n

    Edit the hosts file so that the domain name directly corresponds to the WP Engine IP on the same line. Add a new line to the local hosts section of the host file with the format of: ipaddress domain.com<\/strong><\/p>\n\n\n\n

    For example: IP is 123.456.78.90<\/strong> and the domain is mycooldomain.com<\/strong><\/p>\n\n\n\n

    Therefore, add the following line to the hosts file:<\/p>\n\n\n\n

    123.456.78.90 mycooldomain.com<\/code><\/p>\n\n\n\n

    The steps to editing the hosts file will vary depending on whether you run a PC or a Mac, and also on the version of your operating system. Because of the variations and since there is already good documentation on how to edit the hosts file, we\u2019ve compiled a set of external resources, one of which will fit your particular operating system.<\/p>\n\n\n\n

    Windows operating systems<\/a>
    Mac operating systems<\/a><\/p>\n\n\n\n<\/a>\n\n\n\n

    \n\n\n\n

    Windows Documentation<\/h3>\n\n\n\n

    Windows includes a utility called Hosts File Editor Utility, which makes it easy to manage custom host IPs in a user interface.<\/p>\n\n\n\n

    Learn more about using this utility on Microsoft\u2019s website.<\/a><\/p>\n\n\n\n<\/a>\n\n\n\n

    \n\n\n\n

    Mac OS X Documentation<\/h3>\n\n\n\n

    On a Mac, there are two helpful tools for editing your hosts file called iHosts<\/a> and Gas Mask<\/a>. These applications help you easily manage multiple hosts file entries and edit without entering Terminal or using command line.<\/p>\n\n\n\n<\/a>\n\n\n\n

    \n\n\n\n

    Flush DNS<\/h2>\n\n\n\n

    Last, you will need to flush the DNS cache on your machine so it knows to read the new entries in your hosts file instead of the old, saved entries. On many devices restarting will clear this cache, however to ensure the changes are being observed, we recommend following the steps to manually flush your DNS cache.<\/p>\n\n\n\n

    Steps to flush DNS will vary based on the Operating System of your computer. We have included videos of each below.<\/p>\n\n\n\n

    Windows 10<\/h3>\n\n\n\n
    \n