Setting up an EDS Development Test Environment using Vagrant

Install Vagrant for your platform

Full instructions for all platforms are here: https://www.vagrantup.com/docs/installation/ (NB: you also need Virtualbox 5.0 or higher installed for your platform. Vagrant functions as an automated wrapper and workflow tooling for Virtualbox.)

Pull repo and launch the Vagrant development environment

git clone git@github.com:endeavourhealth/EDS.git

cd EDS (or Windows equivalent: dir EDS)

vagrant up

Vagrant will now do all the work... It will create a virtual machine from and Ubuntu 16.04 (xenial) base box, and then uses the information in the Vagrantfile to set up port forwarding, shared drives, networking, and then Docker-Compose to provision all the required dependencies. Note that Docker and Docker-Compose are installed only to the virtual machine guest (inside Vagrant) so there's no requirement for you to install Docker locally.

Navigate to http://localhost:8080 in your local machine's browser, and the EDS login page should be there.

If you want to interact with the virtual machine via the terminal, simply type vagrant ssh

The 'EDS' folder is shared inside the virtual machine as the folder '/vagrant/' meaning that you can edit files in your normal editor/IDE in your accustomed host environment, and those changes will be automatically synced to inside the virtual machine, where the server is running. Neat 😄