Follow these instructions to create your first website:

  • using a fresh copy of CakePHP 3.x
  • called
  • with Nginx virtual host
  • with two databases (one for testing purposes)

1. Login to your Virtual Machine

Make sure that you are in the cakebox folder on your local machine before running:

vagrant ssh

2. Provision the website

Inside your Virtual Machine run:

cakebox application add

3. Update your hosts file

Open the hosts file on your local machine so you can tell your local system where to find the new website:

  • 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.

Add the following line and save the updated file.    cakebox

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

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

On Windows it should look like this:

Pinging [] 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


That's all there's to it. You can now open the browser on your local system and browse to If things went well you should see something similar to this:

Cakebox Overview

Editing Code

You can use the editor on your local machine to update the (php) source files used by the new website.

Just take a look inside the cakebox/Apps folder on your local machine. If things went well you should see a subfolder named containing all source files. Launch your local editor and make some changes.

Changes to local files are automatically synchronized to your box so if you refresh the web page you should see your changes applied.

Closing Note

Remember that you can provision as many applications as you like. They will all run parallel inside your box so feel free to create another website to get comfortable with the process.

As a closing note you might want to run cakebox application add --help inside your virtual machine to display a list of options you can use to e.g.:

  • provisioning a different framework flavor like Laravel or Yii
  • using HHVM instead of Nginx