Vagrant Phalcon
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 334 commits behind phalcon:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

#Vagrant + Phalcon

This is a simple vagrant setup to get loaded with core development tools to build a powerful PHP application focused on Phalcon Framework.


Landing Page

This is the default page for the Phalcon Vagrant Setup. This page will be empty at the beginning until you start adding VirtualHosts and content to the /www/ folder. Phalcon Vagrant


We use the default Ubuntu Precise 32-bit ISO from Vagrant for compatibility. If you choose to use a 64-bit ISO you may need to update your BIOS to enable virtualization with AMD-V or Intel VT.

When you provision Vagrant for the first time it's always the longest procedure ($ vagrant up). Vagrant will download the entire Linux OS if you've never used Vagrant or the Precise32 Box. Afterwards, booting time is fast.

By default this setup uses 500MB RAM. You can change this in Vagrantfile and simply run $ vagrant reload. You can also use more than one core if you like, simply uncomment these two lines in the same file:

v.customize ["modifyvm", :id, "--cpus", "2"]
v.customize ["modifyvm", :id, "--ioapic", "on"]

Packages Included


  • Operating System: Windows, Linux, or OSX.
  • Virtualbox version 4.3.*
  • Vagrant version 1.4.*

If you have issues with windows and vbguest additions, use the following versions:

  • Virtualbox version 4.2.*
  • Vagrant 1.4.1


First you need a Git enabled terminal. Then you should clone this repository locally.

$ git clone

For newer versions of Vagrant and VirtualBox you may need guest additions, so install the plugin:

# For Linux/OSX
$ vagrant plugin install vagrant-vbguest

# For Windows
$ vagrant plugin install vagrant-windows

Now you are ready to provision your Virtual Machine, run:

$ vagrant up

The script will provision the system with everything needed. Take a look inside if you want to change any default settings. Once provisioned, to access the box, simply type:

$ vagrant ssh

# To exit type:
$ exit

If you want to change your bound address (, edit Vagrantfile, change the ip and run:

$ vagrant reload

If you want to point your Guest Machine (The Virtual Machine OS) to a friendly URL, you could modify your etc/hosts file and add the following:  your-server-name

Vagrant Credentials

These are credentials setup by default:

  • Host Address: (Change in Vagrantfile if you like)
  • SSH: vagrant / vagrant (If root password fails, run $ sudo passwd and set one)
  • MySQL: root / (none)
  • Redis: (none)

Create a Phalcon Project

To create your Phalcon project, head over to the default working directory:

$ cd /vagrant/www

Then run the following command using the Phalcon Dev Tools to see your options:

$ phalcon

To create a project type the following, I'll create one called superstar for this example:

$ phalcon project superstar

This will create a folder called superstar with all your Phalcon files. At this point you have a folder at /vagrant/www/superstar and your VirtualHost will need to point to /vagrant/www/superstar/public

Create a VHost Record

You can have multiple Phalcon projects in subfolders. Make sure to keep your base VirtualHost enabled, in our case it's the vagrant.conf enabled by default. Then follow the instructions below and take note, you must include the ServerPath /project/ in your VirtualHost's.

Do not include a ServerPath for the base vagrant.conf VirtualHost.

$ touch superstar.conf

Then include the following data (Notice the two directory paths with superstar)

<VirtualHost *:80>
    DocumentRoot /vagrant/www/superstar/public
    ServerPath /superstar

<Directory "/vagrant/www/superstar/public">
    Options Indexes Followsymlinks
    AllowOverride All
    Require all granted

Next move your VirtualHost configuration file to sites-available in Apache:

$ sudo mv superstar.conf /etc/apache2/sites-available

Lastly, you must enable your configuration file and restart apache

$ sudo a2ensite superstar
$ sudo service apache2 reload

If you wanted to disable a site:

$ sudo a2dissite superstar
$ sudo service apache2 reload

You should be able to access the following URL's:

Local Editing

On your Host computer open any file explorer or IDE and navigate to /www/. This folder is mounted to the Virtual Machine. Any changes to files within here will reflect realtime changes in the Virtual Machine.

If you are using .git you should initialize your repository locally rather than on the server. This way you will not have to import keys into your Virtual Machine.

Using SSH

Files in the shared directory of www are by default given ownership of www-data:www-data so that you will have no problems with saving cached files. Even with the vagrant user within the www-data group, and even with 0777 write permissions I could't get the cache to save.

So this simply means, if you edit things in the www folder you must run sudo command to do so.

Troubleshooting Vagrant Ubuntu

If you are using Linux such as Ubuntu, you may have to set a different IP that doesn't interfere with DHCP in linux, here is a safe bet:


If you are using the latest VirtualBox with Ubuntu 14, after installing guest additions (below), to fix the error message you will get due to a bug in the guest additions do the following after you run $ vagrant up.

$ vagrant ssh
$ sudo ln -s /opt/VBoxGuestAdditions-4.3.10/lib/VBoxGuestAdditions /usr/lib/VBoxGuestAdditions
$ vagrant reload

Troubleshooting Phalcon

If you are having trouble with Phalcon in this Vagrant Project (Or on your live server), try compiling in safe mode.

If you are having problems with guest-additions on linux with mounting folders run this command in the guest machine:

$ sudo ln -s /opt/VBoxGuestAdditions-4.3.10/lib/VBoxGuestAdditions /usr/lib/VBoxGuestAdditions

Software Suggestions

If you are using Linux you can use the built in Terminal to do everything. The same goes with OSX.

For Windows, you can use Git SCM and Bash.