Getting started with the uoWeb Vagrant build (Ubuntu)

Our Vagrant build allows you to work with a copy of the uoWeb distribution, in an environment similar to our servers. Learn how to work with it on Ubuntu machines (similar instructions will apply to other Linux machines).

These instructions are written for a user with intermediate knowledge of their operating system and is comfortable working with the package manager, virtual machines, and the terminal. These steps were written for Ubuntu LTS 14 and may require some modification on other versions.


Package Installation

  • Install the Java Runtime Environment (JRE) and the Java SE Development Kit (JDK). These tools are necessary to run our recommended editor, Netbeans.
  • Install NetBeans, our recommended editor, and configure it to the uoWeb coding standards. You can use another editor if you like, but you are responsible for ensuring you meet the coding standards.
  • Install Oracle VirtualBox, using the Ubuntu Software Centre.
  • Install the latest version of Vagrant. Do not use the version provided by the Ubuntu Software Centre, as it is too old and will not support the required plugin.
  • Open the terminal and run the following commands: ## Ensure your version of Ubuntu is up to date. sudo apt-get update ## Install the necessary libraries for drush and vagrant sudo apt-get install php-pear php5-dev php5-mysql php5-mcrypt php5-curl php5-gd git ant make unzip re2c openjdk-7-jdk firefox php5-xsl nano vim ## Install drush sudo pear channel-discover sudo pear install drush/drush sudo drush version ## confirm that drush is installed correctly ## Install the Vagrant rsync-back plugin sudo vagrant plugin install vagrant-rsync-back ## Create some folders that you will need mkdir /etc/drush mkdir ~/sites
  • You're now ready to create sites using Vagrant. Here is some information you'll need:
    • Your host file is located at /etc/hosts
    • Your NetBeans sites directory is /home/your-username/sites
» Submit feedback
  • Developers
  • Getting Started
  • Vagrant
Back to top