Choosing an architecture

We've updated our documentation to remove harmful terminology.
Sections

There are several configurations available for Puppet Enterprise. The configuration you use depends on the number of nodes in your environment and the resources required to serve agent catalogs. All PE installations begin with the standard configuration, and scale up by adding additional components as needed.

Configuration Description Node limit
Standard installation (Recommended) All infrastructure components are installed on the primary server. This installation type is the easiest to install, upgrade, and troubleshoot. Up to 4,000
Large installation Similar to a standard installation, plus one or more compilers and a load balancer which help distribute the agent catalog compilation workload. 4,000–20,000
Extra-large installation Similar to a large installation, plus a separate node which hosts the PE-PostgreSQL instance. More than 20,000
Tip: You can add disaster recovery to an installation with or without compilers by configuring a replica of your primary server. Disaster recovery isn't supported with standalone PE-PostgreSQL.

Standard installation


Graphic showing the standard reference architecture, where end users interact with a primary server, and the primary server interacts with multiple agents.

Large installation


Graphic showing a large reference architecture, where end users interact with a primary server. The primary server interacts with multiple compilers and multiple agents.

Extra-large installation


Graphic showing an extra-large reference architecture, where end users interact with a primary server. The primary server interacts with multiple compilers, multiple agents, and a standalone PE-PostgreSQL node.
How helpful was this page?

If you leave us your email, we may contact you regarding your feedback. For more information on how Puppet uses your personal information, see our privacy policy.

Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.