Puppet platform lifecycle
The open source Puppet platform is made up of several
packages: puppet-agent
, puppetserver
, and, optionally, puppetdb
.
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 Welcome to Puppet. 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/7.3).
Puppet version | Puppet Server version | PuppetDB version | Associated PE version | Projected EOL date |
---|---|---|---|---|
8.9.0 | 8.6.3 | 8.7.0 | 2023.x | Superseded by next developmental release. |
7.33.0 | 7.17.2 | 7.19.1 | 2021.7.x | In overlap support. EOL February 2025. |
6.28.0 | 6.20.0 | 6.22 | 2019.8.x | February 2023 |
For information about Puppet's operating system support, see System requirements.
Puppet platform packages
The Puppet platform bundles the components required for a successful deployment. Open source Puppet is distributed in the following packages:
Package | Contents |
---|---|
puppet-agent
|
This package contains Puppet’s
main code and all of the dependencies needed to run it,
including Facter, Hiera, the PXP agent, root certificates,
and bundled versions of Ruby
and OpenSSL. After the package is installed, you have
everything you need to run the
Puppet agent service
and the
|
puppetserver
|
Puppet Server
is a JVM-based application that, among other things,
runs instances of the primary Puppet server 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
|
PuppetDB (optional) collects data generated by Puppet. It enables additional features such as Exported resources, advanced queries, and reports about your infrastructure. |
puppetdb-termini
|
Plugins to connect your primary server to PuppetDB |
The puppetserver
component of the Puppet platform is
available only for Linux. The puppet-agent
component is available independently for over 30
platforms and architectures, including Windows and
macOS.
puppet-agent
component version numbers
Each 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.
puppet-agent
|
Puppet | Facter | Hiera | Resource API | Ruby | OpenSSL |
---|---|---|---|---|---|---|
8.9.0 | 8.9.0 | 4.9.0 | None | 1.9.0 | 3.2.5 | 3.0.15 |
8.8.1 | 8.8.1 | 4.8.0 | None | 1.9.0 | 3.2.4 | 3.0.14 |
8.7.0 | 8.7.0 | 4.7.1 | None | 1.9.0 | 3.2.4 | 3.0.13 |
8.6.0 | 8.6.0 | 4.7.0 | None | 1.9.0 | 3.2.3 | 3.0.13 |
8.5.1 | 8.5.1 | 4.6.1 | None | 1.9.0 | 3.2.3 | 3.0.12 |
8.5.0 | 8.5.0 | 4.6.0 | None | 1.9.0 | 3.2.3 | 3.0.12 |
8.4.0 | 8.4.0 | 4.5.2 | None | 1.9.0 | 3.2.2 | 3.0.12 |
8.3.1 | 8.3.1 | 4.5.1 | None | 1.9.0 | 3.2.2 | 3.0.11 |
8.2.0 | 8.2.0 | 4.4.2 | None | 1.9.0 | 3.2.2 | 3.0.10 |
8.1.0 | 8.1.0 | 4.4.1 | None | 1.8.16 | 3.2.2 | 3.0.8 |
8.0.0 | 8.0.0 | 4.4.0 | None | 1.8.16 | 3.2.2 | 3.0.8 |
7.33.0 | 7.33.0 | 4.9.0 | 3.12.0 | 1.9.0 | 2.7.8 | 1.1.1w |
7.32.1 | 7.32.1 | 4.8.0 | 3.12.0 | 1.9.0 | 2.7.8 | 1.1.1v |
7.31.0 | 7.31.0 | 4.7.1 | 3.12.0 | 1.9.0 | 2.7.8 | 1.1.1v |
7.30.0 | 7.30.0 | 4.7.0 | 3.12.0 | 1.9.0 | 2.7.8 | 1.1.1v |
7.29.1 | 7.29.1 | 4.6.1 | 3.12.0 | 1.9.0 | 2.7.8 | 1.1.1v |
7.29.0 | 7.29.0 | 4.6.0 | 3.12.0 | 1.9.0 | 2.7.8 | 1.1.1v |
7.28.0 | 7.28.0 | 4.5.2 | 3.12.0 | 1.9.0 | 2.7.8 | 1.1.1v |
7.27.0 | 7.27.0 | 4.5.1 | 3.12.0 | 1.9.0 | 2.7.8 | 1.1.1v |
7.26.0 | 7.26.0 | 4.4.2 | 3.12.0 | 1.9.0 | 2.7.8 | 1.1.1v |
7.25.0 | 7.25.0 | 4.4.1 | 3.12.0 | 1.8.16 | 2.7.7 | 1.1.1t |
7.24.0 | 7.24.0 | 4.3.1 | 3.12.0 | 1.8.16 | 2.7.7 | 1.1.1t |
7.23.0 | 7.23.0 | 4.3.0 | 3.11.0 | 1.8.16 | 2.7.7 | 1.1.1q |
7.21.0 | 7.21.0 | 4.2.14 | 3.11.0 | 1.8.16 | 2.7.7 | 1.1.1q |
7.20.0 | 7.20.0 | 4.2.13 | 3.10.0 | 1.8.16 | 2.7.6 | 1.1.1q |
7.19.0 | 7.19.0 | 4.2.12 | 3.10.0 | 1.8.14 | 2.7.6 | 1.1.1q |
7.18.0 | 7.18.0 | 4.2.11 | 3.10.0 | 1.8.14 | 2.7.6 | 1.1.1q |
7.17.0 | 7.17.0 | 4.2.10 | 3.9.0 | 1.8.14 | 2.7.6 | 1.1.1n |
7.16.0 | 7.16.0 | 4.2.8 | 3.8.1 | 1.8.14 | 2.7.6 | 1.1.1n |
7.15.0 | 7.15.0 | 4.2.8 | 3.8.1 | 1.8.14 | 2.7.5 | 1.1.1l |
7.14.0 | 7.14.0 | 4.2.7 | 3.8.0 | 1.8.14 | 2.7.5 | 1.1.1l |
7.13.1 | 7.13.1 | 4.2.6 | 3.8.0 | 1.8.14 | 2.7.3 | 1.1.1l |
7.12.0 | 7.12.0 | 4.2.5 | 3.7.0 | 1.8.14 | 2.7.3 | 1.1.1l |
7.11.0 | 7.11.0 | 4.2.4 | 3.7.0 | 1.8.14 | 2.7.3 | 1.1.1l |
7.10.0 | 7.10.0 | 4.2.3 | 3.7.0 | 1.8.14 | 2.7.3 | 1.1.1k |
7.9.0 | 7.9.0 | 4.2.2 | 3.7.0 | 1.8.14 | 2.7.3 | 1.1.1k |
7.8.0 | 7.8.0 | 4.2.1 | 3.7.0 | 1.8.14 | 2.7.3 | 1.1.1k |
7.7.0 | 7.7.0 | 4.2.0 | 3.7.0 | 1.8.13 | 2.7.0 | 1.1.1i |
7.6.1 | 7.6.1 | 4.1.1 | 3.6.0 | 1.8.13 | 2.7.0 | 1.1.1i |
7.5.0 | 7.5.0 | 4.0.52 | 3.6.0 | 1.8.13 | 2.7.0 | 1.1.1i |
7.4.1 | 7.4.1 | 4.0.51 | 3.6.0 | 1.8.13 | 2.7.0 | 1.1.1i |
7.4.0 | 7.4.0 | 4.0.50 | 3.6.0 | 1.8.13 | 2.7.0 | 1.1.1i |
7.3.0 | 7.3.0 | 4.0.49 | 3.6.0 | 1.8.13 | 2.7.0 | 1.1.1i |
7.1.0 | 7.1.0 | 4.0.47 | 3.6.0 | 1.8.13 | 2.7.0 | 1.1.1i |
7.0.0 | 7.0.0 | 4.0.46 | 3.6.0 | 1.8.13 | 2.7.0 | 1.1.1g |
Server and agent compatibility
Use this table to verify that you're using a compatible version of the agent for your PE or Puppet Server.
Agent | Server | ||
---|---|---|---|
Puppet 6.x PE 2019.1 through 2019.8 |
Puppet 7.x PE 2021.0 through 2023.2 |
Puppet 8.x PE 2023.4 and later |
|
6.x | ✓ | ✓ | ✓ |
7.x | ✓ | ✓ | |
8.x | ✓ |