/vagrant-expressionengine2-application

Basic development server for ExpressionEngine 2 applications. Uses the standard Vagrant Ubuntu Precise base box (precise64.box).

Primary LanguagePuppet

Vagrant ExpressionEngine 2 Application

Basic development server for ExpressionEngine 2.x applications. Uses the standard Vagrant Ubuntu Precise base box (precise64.box).

Requirements

As you might expect, in order for this to work you need:

  1. Vagrant;
  2. An ExpressionEngine 2 project.

Configuration

You may customise the server for your application using the clearly marked "configurable properties" in the following files:

  • /Vagrantfile
  • /puppet/modules/app/manifests/init.pp

Getting started

  1. Download the repository ZIP file;
  2. Unzip it;
  3. Copy the files to the root of your ExpressionEngine 2 application;
  4. Run vagrant up;
  5. Wait a while.

What it does

Creates a virtual machine running a basic LAMP stack, configured to work with your ExpressionEngine application.

In addition to the standard LAMP installation, we:

  • Create a database and user, as per the settings in /puppet/modules/app/manifests/init.pp;
  • Install some useful PHP extensions, including gd (required by ExpressionEngine 2);
  • Set the correct ownership and file permissions as per the ExpressionEngine 2 installation instructions.

What it doesn't do

Modify your /etc/hosts file. You'll need to add your chosen development domain, as follows:

# /etc/hosts
127.0.0.1  my-project.dev

Usage

The following examples assume that your configurable properties are as follows:

  • Hostname: my-project.dev
  • HTTP Port: 8080
  • SSH Port: 2201
  • Database Name: devdb
  • Database User: devdba
  • Database Password: devdba_password

Accessing the site via a browser

Assuming you've added the appropriate entry to your /etc/hosts file, you can access your site at http://my-project.dev:8080/.

Accessing the database using Sequel Pro

You can connect to the database using Sequel Pro (or an equivalent piece of software) using the following settings:

  • Connection Type: SSH
  • MySQL Host: 127.0.0.1
  • Username: devdba
  • Password: devdba_password
  • Database: devdb
  • Port: 3306
  • SSH Host: localhost
  • SSH User: vagrant
  • SSH Key: ~/.vagrant.d/insecure_private_key
  • SSH Port: 2201

Accessing the server via SSH

cd to the directory containing your Vagrantfile (the project root, unless you've done something unexpected), and run vagrant ssh.