Puppet documentation index
This is the documentation for Puppet, as well as several related tools and applications.
Most of the content here applies equally to Puppet Enterprise and open source releases of Puppet, but make sure you’re using the right docs version for your Puppet Enterprise version. If you get lost, check the version note in red text at the top of each page.
Practically speaking, Puppet is a collection of several projects. Here’s the documentation for all of the major components that make up a Puppet deployment:
|Puppet Server||Latest||Other versions|
Cheat sheets and glossary
Small documents for getting help fast.
- Core Types Cheat Sheet — A double-sided reference to the most common resource types.
- Module Cheat Sheet — A one-page reference to Puppet module layout, covering classes and defined types, files, templates, and plugins.
Puppet reference manuals
A concise reference to Puppet’s usage and internals. Use the left sidebar of any reference manual page to navigate between pages.
- Puppet 5.0 (not yet released)
- Puppet 4.10 (latest) (Included in Puppet Enterprise 2017.2)
- Puppet 4.9 (Included in Puppet Enterprise 2017.1)
- Puppet 4.8 (Included in Puppet Enterprise 2016.5)
- Puppet 4.7
- Puppet 4.6
- Puppet 4.5 (Included in Puppet Enterprise 2016.2)
- Puppet 4.4 (Included in Puppet Enterprise 2016.1)
- Puppet 4.3 (Included in Puppet Enterprise 2015.3)
- Puppet 4.2 (Included in Puppet Enterprise 2015.2)
- Puppet 4.1
- Puppet 4.0
- Puppet 3.8 (Included in Puppet Enterprise 3.8)
- Puppet 3.7 (Included in Puppet Enterprise 3.7)
- Puppet 3.6 (Included in Puppet Enterprise 3.3)
- Puppet 3.5
- Puppet 3 (Included in Puppet Enterprise 3.2)
- Puppet 2.7
- Puppet 2.6
- Puppet 0.25
- Puppet 0.24
Note: The “Puppet 3” manual covers versions 3.0 through 3.4.
Other reference material
- Versioned References — Inline reference docs from Puppet’s past and present.
- History of the Puppet Language — A table showing which language features were added and removed in which Puppet versions.
Learn about different areas of Puppet, problem fixes, and design solutions.
Installing and configuring
Get the latest version of Puppet up and running.
- Overview of Puppet’s architecture
- Installing Puppet 4 for Linux
- Installing Puppet 4 for Windows
- Upgrading Puppet from 3.x to 4.x
Previous install guides
Building and using modules
- Module Fundamentals — Nearly all of your Puppet code should be in modules.
- Installing Modules from the Puppet Forge — Save time by using pre-existing modules.
- Publishing Modules on the Puppet Forge — Preparing your best modules to go public.
Help with writing Puppet code
- Style Guide — Puppet Language community conventions.
Using optional features
- Puppet File Serving — Files in modules are automatically served; this explains how to configure additional custom mount points for serving large files that shouldn’t be kept in modules.
Puppet on Windows
You can manage Windows nodes side by side with your *nix infrastructure, with Puppet 2.7 and higher (including Puppet Enterprise ≥ 2.5).
- Installing Puppet 4 for Windows
- Basic tasks and concepts in Windows
- Troubleshooting Puppet on Windows
Tuning and scaling
Puppet’s default configuration is meant for prototyping and designing a site. Once you’re ready for production deployment, learn how to adjust Puppet for peak performance.
- Running a Production-Grade Puppet Master Server With Passenger — This should be one of your earliest steps in scaling out Puppet.
- Using Multiple Puppet Masters — A guide to deployments with multiple Puppet masters.
Hacking and extending: APIs and interfaces
- External Nodes — Specify what your machines do using external data sources.
- LDAP Nodes — A special-case tool for keeping node information in your LDAP directory.
Hacking and extending: Ruby plugins
- Plugins In Modules — Where to put plugins, and how to sync them to clients.
- Writing Custom Facts
- Writing Custom Functions
- Writing Custom Types & Providers
- Complete Resource Example — More information on custom types & providers
- Provider Development — More about providers.