====== Previewing a domain ======

If you would like to preview a domain or website but haven't switched the DNS entries for your domain over to Joyent's name servers yet, you can use Virtualmin, or tweak your local DNS

<note important>Make sure you have enabled the web virtual server, otherwise you will not be able to serve websites from your domain. You can enable the web virtual server from Virtualmin by doing the following:

  - Sign in to Virtualmin (see [[Logins]]).
  - Select a virtual server from the drop-down in the left-hand navigation (your main virtual server should be already selected when you first login to Virtualmin).
  - Click **Edit Virtual Server** in the left-hand navigation. 
  - Click **Enabled features**
  - Select **Web virtual server enabled?** and click **Save Virtual Server**
</note>

===== Using Virtualmin =====

  - Sign in to Virtualmin (see [[Logins]]).
  - Select a domain from the drop-down in the left-hand navigation (your main domain should be already selected when you first login to Virtualmin). The domain you select here will be the one that you'll be previewing.
  - Click **Services** and the click **View Website via Webmin**.

<note warning>Not all elements of your site may show up properly when viewed this way. For example, remote images (images linked from external sources) might appear broken.</note>

===== Tweaking your local DNS =====

The secret here is editing the ''hosts'' file, which your computer always checks //before// asking any information from the valid nameservers of a domain.

On Unix/Linux/OSX, this file is usually located at:

''/etc/hosts''

On most Windows XP systems, this file is located at:

''c:\windows\system32\drivers\etc\hosts''

On most Windows NT/2000 systems (and upgrades from Windows 2000 to XP), this file is located at:

''c:\winnt\system32\drivers\etc\hosts''

On most Windows 95/98/Me systems, this file is located at:

''c:\windows\hosts''

<note tip>If you edit the hosts file with Notepad, be sure that it does not add a .txt extension when you save the file. On Windows XP and 2000 this is not a problem, but on most older versions of Windows you should change the //Save as type// to **All files** in the //Save As dialog//.</note>

Next, add one entry to this file in the form:

<code>111.222.333.444 your.domain.com</code>

Replace //111.222.333.444// with the server IP you are testing/building on. Replace //your.domain.com// with the name you wish to preview. Whitespace is fine between the IP and the domain name - most people use a tab or two. You can also do something like this:

<code>111.222.333.444 yourdomain.com www.yourdomain.com</code>

which will cover both hostnames (with and without the //www//) for your site.

Once you've modified your hosts file, you should also flush your computer's DNS cache. On Unix/Linux/OSX (up to 10.4.x), type the following in the command line:

<code>lookupd -flushcache</code>

Leopard Users will use the following line:
<code>dscacheutil -flushcache</code>

On Windows, start the command promt (from the Start menu, click Run, type cmd, and press Enter) and type the following:

<code>ipconfig /flushdns</code>

Once you've completed all three steps you may also need to refresh or restart your browser.

<note warning>This will only work from your computer - everybody else will still see the real site wherever it is. Also, you should remember to revert the changes to the ''hosts'' file when you are done, otherwise you might forget and lose track of what site you are seeing.</note>