Welcome to the Puppet reference manual. Use the navigation to the left to get around.
For an introduction to how Puppet manages systems, see the Overview of Puppet’s Architecture.
Puppet 4.10 consists of:
puppet-agent
“All-in-One” package that installs Puppet, Ruby, Facter, Hiera, and supporting code.puppetserver
package that installs Puppet Server.puppetdb
package that installs PuppetDB.To install these, read the pre-install instructions, then see the Puppet installation guides for Linux, Windows, and Mac OS X.
Puppet 4 changes many things about how Puppet works, and you must be careful when upgrading from Puppet 3. We’ve made four guides to help walk you through the upgrade process:
Prepare for the upgrade by following the pre-upgrade guide, which covers how to update and move your site’s configuration files to Puppet 4’s revised standards.
Follow our step-by-step instructions to upgrade Puppet Server.
You need to take a few steps before upgrading your Puppet 3 agents. We’ve created a special Puppet module, puppet_agent
, to help; check out the Puppet agent major upgrade documentation for details.
After the upgrade, confirm that everything’s working and clean up your configuration with the post-upgrade guide.
If you’re already running Puppet 4, the minor upgrade guide can help you update Puppet across your infrastructure.
This manual is split into several sections, which can be reached from the left sidebar. A few notable pages: