Puppet platform lifecycle

The 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. To ensure that you have the most recent features, fixes, and security patches, update Puppet Core whenever there is a new version in your release track.

Puppet Core lifecycle

Puppet Core EOL is set at the Puppet Core major-version track major version level (7.x, 8.x, 9.x). It follows the End of Maintenance and Support (EOMS) date of the last Puppet Enterprise (PE) release built on that track for that version of Puppet Core.

As of August 2026, Perforce develops and supports Puppet Core versions 8 and 9 as a proprietary product. As of April 2025, open source Puppet 7 and Puppet Core 7 are end of life (EOL).

Major version EOL Basis
Puppet Core 9.x February 2029 (projected) Follows EOMS of PE 2026.y
Puppet Core 8.x February 2028 (projected) Follows EOMS of PE 2025.y
Puppet Core 7.x April 2025 Superseded by Puppet Core 8.12.0

Puppet Core and open source Puppet releases

The following table provides an overview of Puppet Core and open source Puppet packages and lists recent Puppet, Puppet Server, and PuppetDB versions, with links to their respective documentation.

Puppet version Puppet Server version PuppetDB version Associated PE version
9.0.0 9.0.2 9.0.1 2026.x
8.21.0 8.9.10 8.10.11 2025.x
8.20.0 8.9.9 8.10.10 2025.x, 2023.8.x
8.19.0 8.9.8 8.10.9 2025.x, 2023.8.x
8.18.0 8.9.7 8.10.7 2025.x, 2023.8.x
8.17.0 8.9.5 8.10.6

2025.x, 2023.8.x

8.16.0 8.9.4 8.10.4 2025.x, 2023.8.x
8.15.0 8.9.3 8.10.4 2025.x, 2023.8.x
8.14.0 8.9.2 8.10.3 2025.x, 2023.8.x
8.13.1 8.9.1 8.10.2 2025.x, 2023.8.x
8.13.0 8.9.1 8.10.2 2025.x, 2023.8.x
8.12.0 8.9.0 8.10.0 2025.x, 2023.8.x
8.11.0 8.8.0 8.9.0 2025.x
8.10.0 8.7.0 8.8.0 2023.x
7.35.0 7.17.4 7.21.0 2021.7.x
7.34.0 7.17.3 7.20.0 2021.7.x

 

To access documentation for unmaintained Puppet versions, see Archived documentation.

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. 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 puppet apply command.

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 These are plug-ins that 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 more than 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.

Hiera 5 is a backward-compatible evolution of Hiera, which is built into Puppet. To provide some backward-compatible features, Hiera 5 uses the classic Hiera 3 codebase. This means that Hiera is still shown as version 3.x in the following table, even though this Puppet version uses Hiera 5.
puppet-agentPuppetFacterHieraResource APIRubyOpenSSL
9.0.09.0.04.21.0None2.0.04.0.53.5.7
8.21.08.21.04.21.0None1.9.23.2.113.0.21
8.20.08.20.04.20.0None1.9.03.2.113.0.21
8.19.08.19.04.19.0None1.9.03.2.113.0.20
8.18.08.18.04.18.0None1.9.03.2.103.0.19
8.17.08.17.04.17.0None1.9.03.2.103.0.19
8.16.0 8.16.04.16.0 None 1.9.0 3.2.83.0.18
8.15.08.15.04.15.0None1.9.03.2.83.0.16
8.14.08.14.04.14.0None1.9.03.2.83.0.16
8.13.1 8.13.14.13.0None 1.9.03.2.8 3.0.16
8.13.0 8.13.04.13.0None 2.0.0 3.2.8 3.0.16
8.12.0 8.12.04.12.0None 2.0.0 3.2.8 3.0.16
8.11.0 8.11.04.11.0None 1.9.0 3.2.5 3.0.15
8.10.08.10.04.10.0None1.9.03.2.53.0.15
8.9.08.9.04.9.0None1.9.03.2.53.0.15
8.8.18.8.14.8.0None1.9.03.2.43.0.14
8.7.08.7.04.7.1None1.9.03.2.43.0.13
8.6.08.6.04.7.0None1.9.03.2.33.0.13
8.5.18.5.14.6.1None1.9.03.2.33.0.12
8.5.08.5.04.6.0None1.9.03.2.33.0.12
8.4.08.4.04.5.2None1.9.03.2.23.0.12
8.3.18.3.14.5.1None1.9.03.2.23.0.11
8.2.08.2.04.4.2None1.9.03.2.23.0.10
8.1.08.1.04.4.1None1.8.163.2.23.0.8
8.0.08.0.04.4.0None1.8.163.2.23.0.8
7.35.0 7.35.04.11.0None 1.9.0 2.7.8 1.1.1w
7.34.07.34.04.10.03.12.01.9.02.7.81.1.1w
7.33.07.33.04.9.03.12.01.9.02.7.81.1.1w
7.32.17.32.14.8.03.12.01.9.02.7.81.1.1v
7.31.07.31.04.7.13.12.01.9.02.7.81.1.1v
7.30.07.30.04.7.03.12.01.9.02.7.81.1.1v
7.29.17.29.14.6.13.12.01.9.02.7.81.1.1v
7.29.07.29.04.6.03.12.01.9.02.7.81.1.1v
7.28.07.28.04.5.23.12.01.9.02.7.81.1.1v
7.27.07.27.04.5.13.12.01.9.02.7.81.1.1v
7.26.07.26.04.4.23.12.01.9.02.7.81.1.1v
7.25.07.25.04.4.13.12.01.8.162.7.71.1.1t
7.24.07.24.04.3.13.12.01.8.162.7.71.1.1t
7.23.07.23.04.3.03.11.01.8.162.7.71.1.1q
7.21.07.21.04.2.143.11.01.8.162.7.71.1.1q
7.20.07.20.04.2.133.10.01.8.162.7.61.1.1q
7.19.07.19.04.2.123.10.01.8.142.7.61.1.1q
7.18.07.18.04.2.113.10.01.8.142.7.61.1.1q
7.17.07.17.04.2.103.9.01.8.142.7.61.1.1n
7.16.07.16.04.2.83.8.11.8.142.7.61.1.1n
7.15.07.15.04.2.83.8.11.8.142.7.51.1.1l
7.14.07.14.04.2.73.8.01.8.142.7.51.1.1l
7.13.17.13.14.2.63.8.01.8.142.7.31.1.1l
7.12.07.12.04.2.53.7.01.8.142.7.31.1.1l
7.11.07.11.04.2.43.7.01.8.142.7.31.1.1l
7.10.07.10.04.2.33.7.01.8.142.7.31.1.1k
7.9.07.9.04.2.23.7.01.8.142.7.31.1.1k
7.8.07.8.04.2.13.7.01.8.142.7.31.1.1k
7.7.07.7.04.2.03.7.01.8.132.7.01.1.1i
7.6.17.6.14.1.13.6.01.8.132.7.01.1.1i
7.5.07.5.04.0.523.6.01.8.132.7.01.1.1i
7.4.17.4.14.0.513.6.01.8.132.7.01.1.1i
7.4.07.4.04.0.503.6.01.8.132.7.01.1.1i
7.3.07.3.04.0.493.6.01.8.132.7.01.1.1i
7.1.07.1.04.0.473.6.01.8.132.7.01.1.1i
7.0.07.0.04.0.463.6.01.8.132.7.01.1.1g