Open source Puppet is made up of several packages:
puppetserver, and, optionally,
Understanding what versions are maintained and which versions go together is important when
upgrading and troubleshooting.
Puppet releases and lifecycle
- Update track: Puppet versions that are not associated with any PE version get updated minor (or "y") releases about once a month. Releases in this track include fixes and new features, but typically do not get patch (or "z") releases. Each update in this track supersedes the previous minor release. Documentation for the current release is available at puppet.com/docs/puppet/latest. The latest Release notes contain a history of all updates to this release track.
- Long-term releases: Puppet versions associated with Puppet Enterprise LTS (long-term support) releases get patch (or "z") releases about quarterly. Each release contains bug and security fixes from several developmental releases, but does not get new features. Versioned documentation for long-term releases is available at puppet.com/docs/puppet/<X.Y> (for example, puppet.com/docs/puppet/6.4).
|Puppet version||Puppet Server version||PuppetDB version||Associated PE version||Projected EOL date|
|6.16 (latest)||6.12.x||6.11.x||2019.x||Superseded by next developmental release.|
For information about Puppet's operating system support, see the platform support lifecycle page.
- This package contains Puppet’s main code
and all of the dependencies needed to run it, including Facter, Hiera, and bundled versions of Ruby and OpenSSL. After it’s installed,
you have everything you need to run the
Puppet agent service and the
is a JVM-based application that, among other things, runs
instances of the Puppet master
application and serves catalogs to nodes running the agent service. It
has its own version number and might be compatible with more than one
Puppet version. This package depends
puppet-agent. After it’s installed, Puppet Server can serve catalogs to nodes running the agent service.
- PuppetDB (optional) collects data generated by Puppet. It enables additional features such as exported resources, advanced queries, and reports about your infrastructure.
component version numbers
puppet-agent package contains several components. This table
shows the components shipped in this release track, and contains links to available
component release notes. Agent release notes are included on the same page as Puppet release notes.
|6.7.1||This version of Puppet was never released.|
Master and agent compatibility
Use this table to verify that you're using a compatible version of the agent for your PE or Puppet master.
PE 3.xPuppet 3.x
PE 2015.1 through 2017.2Puppet 4.x
PE 2017.3 through 2018.1Puppet 5.x
PE 2019.1 and laterPuppet 6.x
- Puppet 3.x has reached end of life and is not actively developed or tested. We retain agent 3.x compatibility with later versions of the master only to enable upgrades.
- PE 2019.0 and later uses a new intermediate certificate authority architecture introduced in Puppet Server 6.0. When you update to PE 2019.0 or later, you have several options for whether and when to adopt the new intermediate certificate architecture. For details, see the PE upgrade cautions.