Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Vagrant Skeleton

A bare bones repository to form a "as close as possible" base to a sensibly-configured live server to keep fragmentation of environments to a minimum. There is obviously the advantage of easily portable development environments!

This is a Vagrant skeleton that we used at Better Brief. It still gets used regularly so it's still somewhat regularly maintained.

Guest OS

We're using a CentOS 7 OS, image from chef (thanks)

However, there shouldn't be much issue using these scripts on the following OS's:

  • RHEL
  • Fedora
  • Amazon Linux

Automation and provisioning

We use as much automation as possible during provisioning so that our scripts can be used on other environments and not just on Vagrant boxes. Though it's important to note that some scripts rely on others, order of execution can be important and there are many setting changes that are designed for dev environments only.


The main purpose for this skeleton is for developing SilverStripe sites (as that's our primary framework) so we include a basic environment file for that. However, the skeleton can easily be adapted for any other framework that you want to host on CentOS.


You can use this system on any computer that can run the following software, it's completely platform independent.


To get up and running is very simple.

  1. Copy this repo to a new folder where you develop
  2. Add SQL dump(s) to the database folder with the name of the database the same as the filename
  3. Checkout your PHP code to a webroot folder:
  • www, public and public_html directories, where the full application lives inside the webroot (like SilverStripe), will be auto mounted
  • project/public directories will be auto mounted, where project contains your application, and the public folder contains any public facing code, like Laravel apps.
  • If no webroot is found, the latest SilverStripe will be installed in www
  1. Go to the command line and # vagrant up

This will run the default webserver with the default php modules we need installed. It will also pull in the database(s) automatically.


Edit the Vagrantfile to enable or disable install scripts as they are required.

Included scripts and software

Script Name Version Repo Description Apache 2.x CentOS Mounts the www, public or public_html dir to webroot, installs Apache PHP 5.3.x CentOS Installs PHP 5.4, restarts Apache PHP 5.5.x Webtatic EL6 Installs PHP 5.5, restarts Apache PHP 5.6.x Webtatic EL6 Installs PHP 5.6, restarts Apache MariaDB 5.5 Installs MariaDB, opens port 3306, imports dumps in /vagrant/database PHP Mcrypt extension - EPEL Installs Mcrypt. Only needed for PHP 5.3.x as 5.5 has it built-in. Xdebug extension - PECL Install Xdebug extension for debugging purposes. ntp - CentOS Installs NTP which handles time management NodeJS - Fedora EPEL Installs the NodeJS language and its package manager, NPM Bower - NPM Installs the Bower dependency manager Grunt - NPM Installs the NodeJS based task runner, grunt. Grunt watch daemon - - Sets up an automatic grunt watch task that will run on vagrant up Composer - Installs PHP's composer package manager SSPak - Installs SSPak Asset and database snapshot tool for SilverStripe (link) Ruby, RubyGems, SASS 3.2.10 CentOS Installs SASS 3.4.10, a handy CSS pre processor, and Compass 1.0.3 - - - Various bootstrap tasks and snag fixes


Ideally we'd have scripts and configs that can be used on many environments (including live) however these are just local development environments and none of these are used on a live server.


A base CentOS vagrant setup good for SilverStripe and other PHP frameworks







No packages published