Hardware requirements

Sections

These hardware requirements are based on internal testing at Puppet and are provided as minimum guidelines to help you determine your hardware needs.

Your configuration and code base can significantly affect performance. Use PE tuning and metrics tools to further customize and refine your installation.

Tip:

If possible, address performance limitations by maximizing your hardware first, then scaling up to the next size architecture as needed. It's often easier to upgrade your hardware than to add additional infrastructure nodes.

Hardware requirements for standard installations

These are the minimum hardware requirements for the primary server in a standard architecture with up to 2,500 nodes.

Node volume Cores RAM /opt/ /var/
Trial use 2 8 GB 20 GB 24 GB
11–100 6 10 GB 50 GB 24 GB
101–500 8 12 GB 50 GB 24 GB
501–1,000 10 16 GB 50 GB 24 GB
1,000–2,500 12 24 GB 50 GB 24 GB
  • Trial mode: Although the m5.large instance type is sufficient for trial use, it is not supported. A minimum of four cores is required for production workloads.
  • /opt/ storage requirements: The database should not exceed 50% of /opt/ to allow for future upgrades.
  • /var/ storage requirements: There are roughly 20 log files stored in /var/ which are limited in size to 1 GB each. We recommend allocating 24 GB to avoid issues, however log retention settings generally prevent reaching the maximum capacity.

Hardware requirements for large installations

These are the minimum hardware requirements for the primary server and compilers in a large architecture with 2,500–20,000 nodes.

Each compiler increases capacity by approximately 1,500–3,000 nodes, until you exhaust the capacity of PuppetDB or the console, which run on the primary server.

Node volume Node Cores RAM /opt/ /var/ EC2
2,500–20,000 Primary node 16 32 GB 150 GB 10 GB c5.4xlarge
Each compiler (1,500 - 3,000 nodes) 6 12 GB 30 GB 2 GB m5.xlarge

Hardware requirements for extra-large installations

These are the minimum hardware requirements for the primary server, compilers, and PE-PostgreSQL nodes in an extra-large architecture with 20,000+ nodes.

Node volume Node Cores RAM /opt/ /var/ EC2
20,000+ Primary node 16 32 GB 150 GB 10 GB c5.4xlarge
Each compiler (1,500 - 3,000 nodes) 6 12 GB 30 GB 2 GB m5.xlarge
PE-PostgreSQL node 16 128 GB 300 GB 4 GB r5.4xlarge

If you manage more than 20,000 nodes, contact Puppet professional services to talk about optimizing your setup for your specific requirements

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.