The webserver inside your virtual machine depends on valid records in the hosts file on your local machine to determine which application/URL to serve. Please note that:

  • these records are not inserted automatically, you will have to add them manually
  • all cakebox related entries use the same IP address.

Cakebox Record

You are strongly advised to create a record in your local hosts file that corresponds to the hostname specified in your Cakebox.yaml file. This way you will be able to connect to your box by name.  cakebox

Note: just replace cakebox if you prefer a different hostname.

Adding Records

Add new records by opening the hosts file on your local machine for editing:

  • On Mac OS-X systems: /private/etc/hosts
  • On Linux systems: /etc/hosts
  • On Windows systems: c:\windows\system32\drivers\etc\hosts

Note: Windows users MUST run Notepad as an Administrator (right mouse button on c:\windows\notepad.exe) and then use the File > Open menu options to open the hosts file or they won't be able to save the updated file.

Now either add a single record per line:  cakebox

Or use multiple records per line:    cakebox

Testing Records

You might want to test if your hosts file update was successful by running ping your-new-record on your local machine. On Mac/Linux the output should look similar to:

PING my-new-record ( 56(84) bytes of data.
64 bytes from my-new-record ( icmp_seq=1 ttl=64 time=0.016 ms
64 bytes from my-new-record ( icmp_seq=2 ttl=64 time=0.022 ms
64 bytes from my-new-record ( icmp_seq=3 ttl=64 time=0.022 ms

On Windows it should look like this:

Pinging my-new-record [] with 32 bytes of data:
Reply from bytes=32 time=1ms TTL=64
Reply from bytes=32 time<1ms TTL=64
Reply from bytes=32 time<1ms TTL=64