Basic development server for ExpressionEngine 2.x applications. Uses the standard Vagrant Ubuntu Precise base box (precise64.box
).
As you might expect, in order for this to work you need:
- Vagrant;
- An ExpressionEngine 2 project.
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
1a. If using zip: Download the repository ZIP file and unzip it
1b. If using git clone: Clone and run "git submodule init && git submodule update"
3. Copy the files to the root of your ExpressionEngine 2 application;
4. Run vagrant up
;
5. Wait a while.
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.
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
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
Assuming you've added the appropriate entry to your /etc/hosts
file, you can access your site at http://my-project.dev:8080/
.
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
cd
to the directory containing your Vagrantfile
(the project root, unless you've done something unexpected), and run vagrant ssh
.