Supported architectures

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.

Existing customer deployments in the field might use other configurations, but for the best performance, scalability, and support, we recommend using one of our three defined architectures unless specifically advised otherwise by Puppet Support personnel. For legacy architectures, we document only upgrade procedures – not installation instructions – in order to support existing customers.

Tip: For guidance about deploying PE in global, multi-region, or multi-network segment scenarios, see the Multi-region Reference Architectures article.
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 2,500
Large installation Similar to a standard installation, plus one or more compilers and a load balancer which help distribute the agent catalog compilation workload. 2,500–20,000
Extra-large installation Similar to a large installation, plus one or more separate PE-PostgreSQL nodes that run PuppetDB. 20,000+

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

The extra-large architecture scales PE deployments to 20,000+ nodes. This architecture is intended to be deployed with the help of Puppet solutions experts. For more information about the capabilities of this architecture and how to deploy it, reach out to your technical account manager.


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 one or more separate PE-PostgreSQL nodes that run PuppetDB.

Standalone PE-PostgreSQL (legacy)

Upgrading from the retired split architecture results in a standalone PE-PostgreSQL architecture. This architecture is similar to a large installation, but with a separate node that hosts the PE-PostgreSQL instance. Standalone PE-PostgreSQL can't be configured with disaster recovery.

Graphic showing a standalone PE-PostgreSQL architecture, where end users interact with a primary server. The primary server interacts with multiple compilers, multiple agents, and a standalone PE-PostgreSQL node.