Documentation (beta)

Hosts file configuration for running SyncRelease locally

If you are want to run SyncRelease locally on your computer or within your local network, the simplest way is to add an entry to the machine’s “hosts” file, which holds mapping of a “fake” domain name to a specific IP address, usually your local machine itself whose IP is always 127.0.0.1. Following is how to do it.

Hosts file on Windows

To edit “hosts” file you can use a simple text editor such as Notepad or Notepad++. After opening Notepad application, from “File” menu, click on “Open” and then navigate to “C:WindowsSystem32driversetc” and open “hosts” file. Then add a line as follow

# You can use any fake domain name you want for running SyncRelease locally.
127.0.0.1  syncrelease.mycompany.com

Then save. When you restart your browser and open a new browser window or tab, you type in syncrelease.mycompany.com or any domain name you entered in previous step and then browser will make HTTP request to local machine 127.0.0.1.


NOTE: if you are on Windows Vista, Windows 7 or greater, you will need to open Notepad as System Administrator to have enough permission for changing hosts file.


Hosts file on Linux

Typically on Linux system, hosts file is located at /etc/hosts. For example, on Ubunutu you can edit hosts file by opening it in a command line text-editor program such as nano by issuing command as follow:

sudo nano /etc/hosts

Then enter a line as follow:

# You can use any fake domain name you want for running SyncRelease locally.
127.0.0.1  syncrelease.mycompany.com

And saved it.


Hosts file on Mac

On Mac OS, hosts file is usually located at /private/etc/hosts. Therefore, first open a terminal window, then type in as follow:

sudo nano /private/etc/hosts

Then enter a line as follow:

# You can use any fake domain name you want for running SyncRelease locally.
127.0.0.1  syncrelease.mycompany.com

And save it. Next, you will need to clear DNS flush by issuing command below in terminal window.

dscacheutil -flushcache