Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Helper for using augeas with puppet
Ruby Puppet
Failed to load latest commit information.
lib/puppet/parser/functions Fix augeas() function: use symbol for method name
manifests fix the ruby-augeas gem installation on SLES and openSUSE
spec Fix strict_variables activation with rspec-puppet 2.2
.fixtures.yml Use validate_re to check $augeas::lens_dir in augeas::lens
.gitignore Use modulesync to manage meta files
.puppet-lint.rc Use modulesync to manage meta files
.sync.yml Use forge_password in .sync.yml
.travis.yml Release version 1.2.13
LICENSE Fix LICENSE file issue Update [skip ci]
Rakefile Fix metadata rake task
metadata.json Release version 1.2.13

Augeas Puppet module

Puppet Forge Version Puppet Forge Downloads Build Status Gemnasium By Camptocamp

Install and configure Augeas.

This module is provided by Camptocamp


Simple usage:

include augeas


The module provides an augeas class which installs and configures Augeas.

  • lets you force the augeas version by defining $augeas_version, otherwise puppet will only ensure the packages are present;
  • lets you force the ruby library version by defining $augeas_ruby_version, otherwise puppet will only ensure the libaugeas-ruby version will be installed according to internal critera;
  • provides an augeas() master-side function to manipulate strings using Augeas;

Note: the augeas class realizes all augeas resources in order to ensure they are managed after the required Augeas packages.



The augeas::lens definition allows you to deploy an Augeas lens and any associated test files, running unit tests and not installing if they fail:


  • ensure: present/absent
  • lens_content: the content of the lens
  • lens_source: deprecated, the source for the lens
  • test_content: optionally, the content of the test file
  • test_source: deprecated, the source for the test file.
  • stock_since: optionally, indicate in which version of Augeas the lens became stock, so it will not be deployed above that version.

Example usage:

augeas::lens { 'networkmanager':
  lens_content => file('networkmanager/lenses/networkmanager.aug'),
  test_content => file('networkmanager/lenses/test_networkmanager.aug'),
  stock_since  => '1.0.0',



Modifies a string using Augeas.


augeas("proc        /proc   proc    nodev,noexec,nosuid     0       0\n", 'Fstab.lns', ['rm ./1/opt[3]'])

Would result in:

"proc        /proc   proc    nodev,noexec     0       0\n"
  • Type: rvalue


Please report bugs and feature request using GitHub issue tracker.

For pull requests, it is very much appreciated to check your Puppet manifest with puppet-lint to follow the recommended Puppet style guidelines from the Puppet Labs style guide.

Something went wrong with that request. Please try again.