Hardware requirements
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.
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