Server automation framework and application
Ruby HTML Shell Emacs Lisp Vim script Makefile
Switch branches/tags
upstream/0.25.5 upstream/0.25.4 upstream/0.25.0 upstream/0.24.8 tags/2.6.0rc3 tags/2.6.0rc2 tags/2.6.0rc1 release-0.9.2 puppet-0.24.5-rc3 geordi-published-pe debian/2.6.2-4 debian/2.6.2-3 debian/2.6.2-2 debian/2.6.0-4 debian/2.6.0-3 debian/2.6.0-2 debian/2.6.0-1 debian/0.25.5-1 debian/0.25.4-6 debian/0.25.4-4 debian/0.25.4-2 debian/0.25.3-1 debian/0.25.1 Iteration-2011-04-27-master Iteration-2011-04-27-2.7.x Iteration-2011-04-27-2.6.x Iteration-2011-04-21-master Iteration-2011-04-21-2.7.x Iteration-2011-04-21-2.6.x Iteration-2011-04-13-master Iteration-2011-04-06-master Iteration-2011-04-06-2.6.x Iteration-2011-03-30-master Iteration-2011-03-30-2.6.x Iteration-2011-03-23-master Iteration-2011-03-23-2.6.x Iteration-2011-03-16-master Iteration-2011-03-16-2.6.x Iteration-2011-02-02-master Iteration-2011-02-02-2.6.x Iteration-2011-01-19-master Iteration-2011-01-19-2.6.x Iteration-2011-01-05-master Iteration-2011-01-05-2.6.x Iteration-2010-12-15-master Iteration-2010-12-15-2.6.x Iteration-2010-11-24 Iteration-2010-11-17 Iteration-2010-11-10 Iteration-2010-11-03 BetaOne Beta1 3.1.0 3.1.0-rc2 3.1.0-rc1 3.0.2 3.0.2-rc3 3.0.2-rc2 3.0.2-rc1 3.0.1 3.0.1-rc1 3.0.0 3.0.0rc3 3.0.0rc2 3.0.0rc1 3.0.0-rc8 3.0.0-rc7 3.0.0-rc6 3.0.0-rc5 3.0.0-rc4 2.7.20 2.7.20-rc1 2.7.19 2.7.19rc3 2.7.19rc2 2.7.19rc1 2.7.18 2.7.17 2.7.16 2.7.16rc1 2.7.15rc4 2.7.15rc3 2.7.15rc2 2.7.15rc1 2.7.14 2.7.14rc3 2.7.14rc2 2.7.14rc1 2.7.13 2.7.12 2.7.12rc2 2.7.12rc1 2.7.11-1 2.7.10 2.7.10rc1 2.7.9 2.7.8 2.7.8rc2 2.7.8rc1 2.7.7
Nothing to show
Pull request Compare This branch is 4333 commits behind puppetlabs:master.
Latest commit e485df7 Jun 16, 2016 @whopper whopper Merge pull request #5019 from ody/PUP-6370-honor-systemd-exit-code
(PUP-6370) Honor systemd exitcodes as truth
Failed to load latest commit information.
acceptance Merge pull request #4925 from johnduarte/pup-5284 Jun 6, 2016
api (PUP-6369) Add noop_pending flag to puppet report Jun 16, 2016
autotest (maint) Ensure every file has a trailing newlines Apr 23, 2012
benchmarks (PUP-5482) Add a benchmark to missing type caching Apr 4, 2016
bin (PUP-2563) Exit with 1 on pre-1.9.3 ruby Dec 4, 2014
conf (docs) Update URLs for generated references Mar 18, 2016
docs (maint) Update docs and license with new branding Apr 21, 2016
examples/hiera (Maint) Update commands to use new forms in hiera examples Sep 19, 2013
ext (maint) Remove dead scripts May 20, 2016
lib Merge pull request #5019 from ody/PUP-6370-honor-systemd-exit-code Jun 16, 2016
man (PUP-5123) Replace http:// links with https:// Nov 9, 2015
spec Merge pull request #5019 from ody/PUP-6370-honor-systemd-exit-code Jun 16, 2016
tasks (PUP-1455) Use CFPropertyList to read launchd plists Dec 23, 2015
util (PUP-3912) Update parallel:spec task for rspec 3 Jan 26, 2015
yardoc/templates/default (#18023) Document user facing classes using yardoc and show api. Jan 5, 2013
.gemspec Revert "(PUP-4742) Switch to use semantic_puppet gem" Jun 7, 2016
.gitignore (PUP-4347) Add test for the File resource ignore attribute May 5, 2015
.hound.yml (maint) Point HoundCI at the existing rubocop config Mar 24, 2016
.mailmap (maint) Update mailmap for git shortlog Oct 18, 2012
.noexec.yaml (#15464) Exclude gem command from bundler Aug 20, 2012
.rubocop.yml (PUP-5545) Rubocop to ignore files in the module skeleton May 4, 2016
.travis.yml (maint) Bump to ruby 2.3.1 in travis ci May 1, 2016
.yardopts (maint) Remove reference to README_DEVELOPER Apr 22, 2014 (PUP-5123) Replace http:// links with https:// Nov 9, 2015 (maint) Update docs and license with new branding Apr 21, 2016
Gemfile Revert "(PUP-4742) Switch to use semantic_puppet gem" Jun 7, 2016
LICENSE (maint) Update docs and license with new branding Apr 21, 2016 (maint) Add maintainers section to readme Apr 24, 2016
Rakefile (maint) Update commit rake task to allow revert Aug 20, 2015
appveyor.yml (maint) Skip updating bundler in AppVeyor Mar 2, 2016
install.rb (maint) Update install.rb to actually honor InstallOptions.batch_files May 20, 2016


Build Status Inline docs

Puppet, an automated administrative engine for your Linux, Unix, and Windows systems, performs administrative tasks (such as adding users, installing packages, and updating server configurations) based on a centralized specification.


Documentation for Puppet and related projects can be found online at the Puppet Docs site.




The best way to run Puppet is with Puppet Enterprise, which also includes orchestration features, a web console, and professional support. The PE documentation is available here.

To install an open source release of Puppet, see the installation guide on the docs site.

If you need to run Puppet from source as a tester or developer, see the running from source guide on the docs site.

Developing and Contributing

We'd love to get contributions from you! For a quick guide to getting your system setup for developing take a look at our Quickstart Guide. Once you are up and running, take a look at the Contribution Documents to see how to get your changes merged in.

For more complete docs on developing with puppet you can take a look at the rest of the developer documents.


See LICENSE file.


Please log tickets and issues at our JIRA tracker. A mailing list is available for asking questions and getting help from others. In addition there is an active #puppet channel on Freenode.

We use semantic version numbers for our releases, and recommend that users stay as up-to-date as possible by upgrading to patch releases and minor releases as they become available.

Bugfixes and ongoing development will occur in minor releases for the current major version. Security fixes will be backported to a previous major version on a best-effort basis, until the previous major version is no longer maintained.

For example: If a security vulnerability is discovered in Puppet 4.1.1, we would fix it in the 4 series, most likely as 4.1.2. Maintainers would then make a best effort to backport that fix onto the latest Puppet 3 release.

Long-term support, including security patches and bug fixes, is available for commercial customers. Please see the following page for more details:

Puppet Enterprise Support Lifecycle