Open source Puppet is made up of
puppetserver, and, optionally,
puppetdb. Understanding what versions
are maintained and which versions go together is important
when upgrading and troubleshooting.
Puppet releases and lifecycle
- Developmental releases: Puppet versions not associated with any PE version release new minor (or "y") version about once a month. Developmental releases typically do not get patch (or "z") releases. Each minor release in this stream supersedes the previous minor release. Documentation for the current developmental release is available at puppet.com/docs/puppet/latest. See the release notes for updates to this release stream.
- Long-term releases: Puppet versions associated with Puppet Enterprise get patch (or "z") releases a few times a year. Each release contains fixes and features from several developmental releases. 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||EOL date|
|6.12.0 (latest)||6.8.0||6.8.0||None||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,
Hiera, and bundled
versions of Ruby
and OpenSSL. After it’s installed, you have
everything you need to run the Puppet agent service
Puppet Server 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 on
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
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
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.
You can use pre-6.x agents with a Puppet 6.x or PE 2019.0 or later master, but this combination doesn't take advantage of the new intermediate certificate authority architecture introduced in Puppet Server 6.0. To adopt the new CA architecture, both your master and agents must be upgraded to at least 6.x/2019.0, and you must regenerate certificates. If you don't upgrade all of your nodes to 6.x, do not regenerate your certificates, because pre-6.x agents won't work with the new CA architecture.