PE and open source version numbers

This version is out of date. For current versions, see Puppet Enterprise support lifecycle.

In October 2018, the "x.y.z" version numbering system for Puppet Enterprise (PE) changed so that the first number ("x") changes only when PE adopts a new major version of the Puppet Platform.

We made this change to so that it's easier for you to determine whether a release contains potentially high-impact breaking changes. Previously, the "x" part of the version number incremented with each new calendar year, whether or not there were breaking changes in the release.

The "y" and "z" numbers continue to increment with minor and patch releases, respectively.
Type of changeMajor "x" releasesMinor "y" releasesPatch "z" releases
Security updatesyesyesyes
Bug fixesyesyesyes
Minor improvementsyesyesyes
Major improvementsyesyesno
New featuresyesyesno
Low-impact breaking changesyesyesno
High-impact breaking changesyesnono

For example, if you are using PE 2018.1.3, then upgrading to PE 2019 likely introduces changes that involve updating your Puppet code, depending on what features you use and what we added. Upgrading to 2018.1.4 fixes bugs and security problems, and might slightly adjust how a feature looks. 

Note: This version of documentation represents the latest Z release in this series. There might be minor variances in workflows from previous Zs.

The first release to use the updated system is Puppet Enterprise 2019.0. Older release streams follow the previous version numbering system.

For information about active PE releases, mainstream and extended support, and end of life dates, see Puppet Enterprise support lifecycle.

Open source version numbers

All of our open source projects—including Puppet, PuppetDB, Facter, and Hiera—use semantic versioning ("semver"). This means that in an x.y.z version number, the "y" increases if new features are introduced and the "x" increases if existing features change or get removed.

Our semver refers to only the code within that project; it's possible that packaging or interactions with other projects might cause new behavior in a "z" upgrade of Puppet.

Note: In Puppet versions prior to 3.0.0 and Facter versions prior to 1.7.0, we didn't use semver.
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.