To install Puppet 3.8, see the Puppet installation guide.
The Puppet agent service has no particular hardware requirements and can run on nearly anything.
However, the Puppet master service is fairly resource intensive, and should be installed on a robust dedicated server.
- At minimum, your Puppet master server should have two processor cores and at least 1 GB RAM.
- To comfortably serve at least 1,000 nodes, it should have 2-4 processor cores and at least 4 GB RAM.
The demands on the Puppet master will vary widely between different deployments. The total needs are affected by the number of agents being served, how frequently those agents check in, how many resources are being managed on each agent, and the complexity of the manifests and modules in use.
Platforms With Packages
Puppet provides official packages or repositories for Puppet 3.8 and its prerequisites on the following operating systems.
Red Hat Enterprise Linux (and Derivatives)
Puppet publishes and tests open-source Puppet 3.8 packages for the following versions of Red Hat Enterprise Linux (RHEL) to yum.puppetlabs.com:
- Enterprise Linux 7
- Enterprise Linux 6
- Enterprise Linux 5
- Enterprise Linux 4
This also applies to any distributions that maintain binary compatibility with RHEL, including but not limited to CentOS, Scientific Linux, and Oracle Linux.
Puppet Enterprise support: PE 3.8 supports 32-bit and 64-bit agents on these versions of RHEL and compatibile operating systems, but doesn’t support masters on Enterprise Linux 4 and 5, or on 32-bit architectures.
See the Enterprise Linux installation instructions for details.
Puppet publishes and tests open-source Puppet 3.8 packages for Fedora 20 to yum.puppetlabs.com.
See the Fedora installation instructions for details.
Debian and Ubuntu
Puppet publishes and tests open-source Puppet 3.8 packages for the following versions of Debian to apt.puppetlabs.com:
- Debian 7 “Wheezy” (previous stable release)
- Debian 6 “Squeeze” (obsolete stable release)
Puppet publishes and tests packages for the following versions of Ubuntu to apt.puppetlabs.com:
- Ubuntu 14.04 LTS “Trusty Tahr”
- Ubuntu 12.04 LTS “Precise Pangolin”
Ubuntu 10.04 LTS reached its end-of-life in April 2015.
Puppet Enterprise support: PE 3.8 supports these operating systems, but supports masters only on 64-bit editions of Ubuntu. Newer versions of Puppet Enterprise support more agents on more recent versions of Debian and Ubuntu, and masters on more recent versions of Ubuntu.
See the Debian and Ubuntu installation instructions for details.
Puppet publishes and tests open-source Puppet 3.8 agent installers for the following versions of Microsoft Windows to downloads.puppetlabs.com/windows:
- Windows Server 2012 R2
- Windows Server 2008 R2
- Windows Server 2003 R2
Puppet also publishes, but does not automatically test, open-source Puppet 3.8 packages for the following versions of Windows:
- Windows Server 2012
- Windows Server 2008
- Windows Server 2003
- Windows 7
- Windows 8
- Windows 8.1
- Windows Vista
The Puppet master service is not available on any version of Windows.
Puppet Enterprise support: PE 3.8 supports agents on 32-bit versions of Windows Server 2003 and 2003 R2, and on both 32-bit and 64-bit versions of Windows Server 2008, 2008 R2, 2012, and 2012 R2; Windows 7 Ultimate SP 1; and Windows 8 and 8.1 Pro. It does not support agents on any version of Windows Vista. Newer versions of Puppet Enterprise support more recent versions of Windows.
See the Windows agent installation instructions for details.
Puppet publishes and tests open-source Puppet 3.8 agent installers for the following versions of OS X to downloads.puppetlabs.com/mac:
- 10.10 “Yosemite”
- 10.9 “Mavericks”
The Puppet master service is not available on any version of OS X.
See the OS X agent installation instructions for details.
Platforms Without Packages
Puppet and its prerequisites are known to run on the following platforms, but we do not provide official packages and do not perform automated testing.
- SUSE Linux Enterprise Server, version 11 and higher
- Gentoo Linux
- Mandriva Corporate Server 4
- Arch Linux
- Oracle Solaris, version 10 and higher (Puppet performs limited automated testing on Solaris 11.)
- AIX, version 5.3 and higher
- FreeBSD 4.7 and later
- OpenBSD 4.1 and later
If you’re installing Puppet via the official packages, you won’t need to worry about these prerequisites; your system’s package manager will handle all of them. These are only listed for those running Puppet from source or on unsupported systems.
Puppet 3.8 has the following prerequisites:
Use one of the following versions of MRI (standard) Ruby:
- 2.1.x — Note: We run spec tests for Ruby 2.1, but since none of our tested platforms ship with it yet, we don’t run acceptance tests on it. This means we think it’s good, but it might have problems we don’t know about yet.
Other interpreters and versions of Ruby are not covered by our tests, and may or may not work.