How to configure PE

After you've installed Puppet Enterprise (PE), you can optimize it by configuring and tuning settings. For example, you might want to add your certificate to the allowlist, increase the max-threads setting for http and https requests, or configure the number of JRuby instances.

PE shares configuration settings used in open source Puppet (which are documented in the Configuration Reference). However, the default values for PE might differ from the default values for Puppet. Some examples of settings that have different defaults in PE include disable18n, environment_timeout, always_retry_plugins, and the Puppet ServerJRubymax-active-instances settings. To verify PE's configuration defaults, check the puppet.conf file after installation.

There are three ways to configure PE settings:

• Configure settings in the PE console
• Configure settings with Hiera
• Configure settings in pe.conf

For consistency, it is important to always configure settings in the same way, unless a situation calls for you to use a specific method. For example, if you choose to configure settings in the PE console, then always configure settings in the console, unless a specific setting requires using Hiera or editing pe.conf.

This page provides generic instructions for configuring PE settings. You'll find information about specific settings in other Configuring Puppet Enterprise topics and throughout the PE documentation.