Forge Home


Maintain symbolic links determining default commands


263,483 latest version

4.4 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.3.0 (latest)
  • 0.2.0
  • 0.1.1
  • 0.1.0
released Dec 18th 2014
This module has been deprecated by its author since Oct 5th 2022.

The author has suggested puppet-alternatives as its replacement.

Start using this module


adrien/alternatives — version 0.3.0 Dec 18th 2014


Manage alternatives symlinks.


Using puppet resource to inspect alternatives

root@master:~# puppet resource alternatives
alternatives { 'aptitude':
  path => '/usr/bin/aptitude-curses',
alternatives { 'awk':
  path => '/usr/bin/mawk',
alternatives { 'builtins.7.gz':
  path => '/usr/share/man/man7/bash-builtins.7.gz',
alternatives { 'c++':
  path => '/usr/bin/g++',
alternatives { 'c89':
  path => '/usr/bin/c89-gcc',
alternatives { 'c99':
  path => '/usr/bin/c99-gcc',
alternatives { 'cc':
  path => '/usr/bin/gcc',

Using puppet resource to update an alternative

root@master:~# puppet resource alternatives editor
alternatives { 'editor':
  path => '/bin/nano',
root@master:~# puppet resource alternatives editor path=/usr/bin/vim.tiny
notice: /Alternatives[editor]/path: path changed '/bin/nano' to '/usr/bin/vim.tiny'
alternatives { 'editor':
  path => '/usr/bin/vim.tiny',

Using the alternatives resource in a manifest:

class ruby::193 {

  package { 'ruby1.9.3':
    ensure => present,

  # Will also update gem, irb, rdoc, rake, etc.
  alternatives { 'ruby':
    path    => '/usr/bin/ruby1.9.3',
    require => Package['ruby1.9.3'],

# magic!
include ruby::193

This module should work on any Debian and RHEL based distribution.