This repository contains Vagrant configurations for local iRODS VMs.

• Install VirtualBox
• Install Vagrant 2.x
• Install the vagrant-env and vagrant-disksize plugin: vagrant plugin install vagrant-env vagrant-disksize

• irods-single-server: a basic plain vanilla iRODS server for local testing.
• irods-provider-consumer: an iRODS zone consisting of a provider and a single consumer. The VMs are meant for local testing, and run with default key values.
• irods-icommands: a VM which contains the icommands tools for remote administration of iRODS.

These scripts should support the 4.2.x and 4.3.x iRODS versions that are available through the package repositories. As of 2 May 2024, versions 4.2.2 through 4.2.12, as well as 4.3.0 through 4.3.2, are available in the repositories.

The following distributions are supported:

• iRODS 4.2.x: CentOS7 and Ubuntu 18.04 LTS (bionic)
• iRODS 4.2.12 and 4.3.x: Ubuntu 20.04 LTS (focal)

• If you use Windows, ensure that core.autocrlf is set to false in your git client before you clone the Vagrant-irods repository: git config --global core.autocrlf false
• Clone the vagrant-irods repository: git clone https://github.com/utrechtuniversity/vagrant-irods.git
• Go to the configuration directory. For example : cd vagrant-irods/irods-single-server
• Optionally adjust the settings in the .env file. You might want to change the image of the VM, the amount of memory assigned to the VM or the iRODS version to be installed.
• Start and provision the VM(s): vagrant up
• After the VM is provisioned, you should be able to log in using vagrant ssh. In case of the provider-consumer setup, use vagrant ssh provider or vagrant ssh consumer.