litmus logo


Litmus provides a simple command line tool for Puppet content creators, to enable both simple and complex test deployments against specifically configured target systems. It is available as a gem, and can be installed by running gem install puppet_litmus.

Litmus allows Puppet module developers to:

  • provision targets to test against,
  • install the Puppet Agent,
  • install a module,
  • run tests, and
  • tear down the infrastructure.

The tool facilitates parallel test runs, running tests in isolation, and each step is standalone, allowing other operations between test runs, such as debugging, or configuration updates on the test targets.


All our documentation is currently available in the Wiki.

Other Resources