Puppet Enterprise user's guide

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

Welcome to the Puppet Enterprise user’s guide!

Puppet Enterprise makes it easy to automate the provisioning, configuration and ongoing management of your machines and the software running on them. Make rapid, repeatable changes and automatically enforce the consistency of systems and devices - across physical and virtual machines, on premise or in the cloud.

  • Reduce cycle times to get more software deployed
  • Make fast, iterative changes
  • Define a configuration once, and apply it to thousands of machines
  • Automatically remediate configuration drift
  • Get detailed insight into hardware and software configurations

Can’t find what you’re looking for? Use the navigation to the left to find additional topics.

If you’re using an older version of Puppet Enterprise, you can find documentation for previous versions here.

If you’ve never used PE before and want to evaluate it, download PE with 10 complimentary licenses and follow the Puppet Enterprise quick start guide for *nix users or Windows users. This walkthrough will guide you through creating a small proof-of-concept deployment while demonstrating the core features and workflows of PE.

You can download and install Puppet Enterprise on up to 10 nodes at no charge, and no license key is needed. Read more about the PE license key on the Installing the license key page.

Here are some useful links for getting started:

Release notes
New features
Known issues
Resolved issues
Quick start guides
For *nix users
For Windows users
Puppet Enterprise’s services and components
The PE architecture overview explains major services and components.
What gets installed and where? lists symlinks, services, users, and log file locations.
Installing Puppet Enterprise
System requirements
Web-based monolithic installation instructions
Text-mode installation instructions
*nix agent installation
Windows agent installation
Node management and role-based access control
Getting started with classification
Working with role-based access control
Enforcing change with Puppet Orchestrator
Puppet orchestrator
Direct Puppet: a workflow
Managing and deploying Puppet code
Managing and deploying Puppet code
Code Manager
Provisioning with Razor
Bare-metal provisioning with Razor
Setting up a Razor environment
Installing Razor
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.