Islandora testing and development environment
Branch: 7.x
Clone or download
Latest commit 8c8a6ea Jan 10, 2019

Islandora Vagrant Build Status


The is a development environment virtual machine for Islandora 7.x-1.x. It should work on any operating system that supports VirtualBox and Vagrant.

N.B. This virtual machine should not be used in production.


  1. VirtualBox
  1. Vagrant
  • Important: be sure to install Vagrant version 2.0.3 or higher
  • If upgrading from a previous version run vagrant plugin update to avoid plugin issues
  1. git

Note that virtualization must be enabled in the host machine's BIOS settings.


System Resources

By default the virtual machine that is built uses 3GB of RAM. Your host machine will need to be able to support that. You can override the CPU and RAM allocation by creating ISLANDORA_VAGRANT_CPUS and ISLANDORA_VAGRANT_MEMORY environment variables and setting the values. For example, on an Ubuntu host you could add to ~/.bashrc:


The files involved will also exceed 10GB. Your host machine will need at least that much free storage.

Hostname and Port Forwarding

If you use a DNS or host file management plugin with Vagrant, you may want to set a specific hostname for the virtual machine and disable port forwarding. You can do that with the ISLANDORA_VAGRANT_HOSTNAME and ISLANDORA_VAGRANT_FORWARD variables. For example:

export ISLANDORA_VAGRANT_HOSTNAME="islandora.vagrant.test"


  1. git clone
  2. cd islandora_vagrant
  3. vagrant up


Note: The supplied links apply only to this local vagrant system. They could vary in other installations.

You can connect to the machine via the browser at http://localhost:8000.

The default Drupal login details are:

  • username: admin
  • password: islandora


  • username: root
  • password: islandora

Tomcat Manager:

  • username: islandora
  • password: islandora

Fedora: (Fedora Admin | Fedora Risearch | Fedora Services)

  • username: fedoraAdmin
  • password: fedoraAdmin


  • username: fedoraAdmin
  • password: fedoraAdmin

cantaloupe admin:

  • username: admin
  • password: admin

ssh, scp, rsync:

  • username: vagrant
  • password: vagrant
  • Examples
    • ssh -p 2222 vagrant@localhost or vagrant ssh
    • scp -P 2222 somefile.txt vagrant@localhost:/destination/path
    • rsync --rsh='ssh -p2222' -av somedir vagrant@localhost:/tmp


  • Ubuntu 14.04
  • Drupal 7.44
  • MySQL 5.5.49
  • Apache 2.4.7
  • Tomcat
  • Solr 4.2.0
  • Fedora 3.8.1
  • GSearch HEAD
  • PHP 5.5.9-1ubuntu4.17
  • Java 8 (Oracle)
  • FITS 0.10.1
  • drush 6.3.0
  • jQuery 1.10.2




This project was inspired by Ryerson University Library's Islandora Chef, which was inspired by University of Toronto Libraries' LibraryChef. So, many thanks to Graham Stewart, and MJ Suhonos.