Skip to main content
Table of contents

Development VM

Run an application in the VM

Before running an application in the VM, it’s worth first checking whether you can use GOV.UK Docker to run your application instead.

You can use bowler to run an application, it will also run all dependent services and applications. The applications are listed in the Pinfile.

$ cd /var/govuk/govuk-puppet/development-vm
$ bowl search-api

If you want to run an application in development mode with the static assets served from your local copy, run bowler with the STATIC_DEV variable defined and make sure you’re not setting static=0:

$ STATIC_DEV="" bowl planner static

To run a single application without the dependencies you can use foreman. The available apps are defined in the Procfile.

$ cd /var/govuk/govuk-puppet/development-vm
$ foreman start search-api

Most apps also have a script in their root folder, and you can run that directly too:

$ cd /var/govuk/search-api
$ ./
This page was last reviewed on 27 September 2019. It needs to be reviewed again on 27 December 2019 by the page owner #govuk-2ndline .
This page was set to be reviewed before 27 December 2019 by the page owner #govuk-2ndline. This might mean the content is out of date.