Forge Home


Install OCaml and Opam packages required for MirageOS


8,802 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.1.0 (latest)
released May 6th 2015
This version is compatible with:
  • Puppet Enterprise 3.7
  • Puppet >= 3.7.0

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'garethr-mirageos', '0.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add garethr-mirageos
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install garethr-mirageos --version 0.1.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



garethr/mirageos — version 0.1.0 May 6th 2015

Forge Build
Status Puppet Forge

This Puppet module installs OCaml, relevant libraries from OPAM and MirageOS. This allows you to get on with building Mirage unikernels quickly.


The module is currently tested on Ubuntu 14.04 and 12.04. You can use it like so:

include mirageos

By default this installs Mirage as root and installs OPAM modules to /usr/local/opam. This can be modified like so:

class { 'mirageos':
  user      => 'vagrant',
  opam_root => '/home/vagrant/.opam',

A note on testing

This module features a unit and acceptance test suite. The unit tests can be run with:

bundle install
FUTURE_PARSER=yes bundle exec rake test

This checks the metadata, the syntax of the puppet manifests and runs the unit tests.

In addition the module includes an acceptance testing suite using Test Kitchen. This runs the module on Ubuntu 12.04 and 14.04, asserts that things have been installed successfully and then compiles a unix unikernel and checks it runs successfully. This suite can be run with:

bundle install
bundle exec kitchen test -c=2