Forge Home


Puppet server installation and setup


54 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.19.3 (latest)
  • 0.19.1
  • 0.14.0
  • 0.10.0
  • 0.8.0
  • 0.7.1
  • 0.6.1
  • 0.5.2
  • 0.4.3
  • 0.4.2
  • 0.4.1
  • 0.4.0
  • 0.3.6
  • 0.3.5
  • 0.3.4
  • 0.3.2
  • 0.3.1
  • 0.1.5
  • 0.1.3
released Jun 17th 2024
This version is compatible with:
  • Puppet Enterprise 2023.7.x, 2023.6.x, 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 9.0.0
  • , ,
  • hostname
  • clean
  • hostname
  • install
  • run
  • bootstrap
  • clean
  • sign
  • and 3 more. See all plans

Start using this module

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

Add this module to your Puppetfile:

mod 'aursu-puppet', '0.19.3'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add aursu-puppet
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install aursu-puppet --version 0.19.3

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.



aursu/puppet — version 0.19.3 Jun 17th 2024


Table of Contents

  1. Description
  2. Setup - The basics of getting started with puppet
  3. Usage - Configuration options and additional functionality
  4. Limitations - OS compatibility, etc.
  5. Development - Guide for contributing to the module


This Puppet module is primarily designed to manage the Puppet server itself, automating its configuration, deployment, and maintenance tasks. This ensures the Puppet server operates efficiently and remains up-to-date.

Additionally, the module includes functionality to manage the Puppet agent as well.


This module can be utilized in two primary ways:

  1. As a Regular Puppet Module (e.g., included in a Puppetfile)

    For direct inclusion in your Puppet environment, specify the module in your Puppetfile as follows:

    mod 'puppet',
      git: '',
      tag: 'v0.19.1'

    Alternatively, you can specify the version directly if it’s available from the module repository on Puppet Forge:

    mod 'aursu/puppet', '0.19.1'
  2. As a Puppet Server Bootstrap Tool Using Puppet Bolt

    The module includes a Bolt project located in the bootstrap/bolt subfolder. Within this project, there is a Bolt plan named puppet_bootstrap::server that is specifically designed for bootstrapping a Puppet server.

    Using this setup with Puppet Bolt facilitates a more efficient and straightforward installation process for the Puppet server. This method provides a predefined sequence of actions that automate much of the manual setup, streamlining the deployment of Puppet server environments. It also significantly reduces the complexity of the initial server configuration.

    Initiate the bootstrapping and subsequent Puppet agent run in the production environment with the following commands:

    bolt plan run puppet_bootstrap::server -t puppetservers
    bolt plan run puppet_agent::run -t puppetservers environment=production

    For a more detailed description, refer to the bootstrap directory.

What puppet affects

When integrated into a Puppet catalog to configure a Puppet server, the puppet module offers comprehensive control over several crucial configurations and components of both the Puppet server and the overall Puppet infrastructure:

Setup Requirements OPTIONAL

Beginning with puppet