Skip FOLIO Project Navigation


  • Explain how to utilise a FOLIO virtual machine (VM).


  • Vagrant – Recent version.
  • VirtualBox – Determine the version of VirtualBox to match your version of vagrant.
  • curl – Only curl commands are shown in this tutorial. (Those could be utilised via Postman.)


Each night the FOLIO reference environments are rebuilt using the current state of development.

The continuous integration also constructs various Vagrant boxes. These are available to download for local use, providing a ready-to-run self-contained operating system environment and up-to-date FOLIO instance.

This tutorial will only focus on the folio/snapshot-core VM.

Troubleshooting and known issues

There are troubleshooting notes in the folio-ansible repository, so generally those will not be repeated here.

Lessons and steps

Follow each lesson sequentially:

  1. Create workspace and launch VM and update box.
  2. VM system overview and viewing logfiles.
  3. Interact with the FOLIO VM.
  4. Conduct local development.