Puppet Server is configured to use 2 GB of RAM by default. If you’d like to just play around with an installation on a Virtual Machine, this much memory is not necessary. To change the memory allocation, see Memory Allocation.
If you’re also using PuppetDB, check its requirements.
Enable the Puppet package repositories, if you haven’t already done so.
Install the Puppet Server package by running:
yum install puppetserver
or
apt-get install puppetserver
There is no -
in the package name.
Note: If you’re upgrading, stop any existing
puppetmaster
orpuppetserver
service by runningservice <service_name> stop
orsystemctl stop <service_name>
.
systemctl start puppetserver
or
service puppetserver start
Puppet provides official packages that install Puppet Server 5.1 and all of its prerequisites on x86_64 architectures for the following platforms, as part of Puppet Platform.
Note: Java 8 runtime packages do not exist in the standard repositories for Debian 8 (Jessie). To install Puppet Server on Jessie, configure the
jessie-backports
repository.
For platforms and architectures where no official packages are available, you can build Puppet Server from source. Such platforms are not tested, and running Puppet Server from source is not recommended for production use.
For details, see Running from Source.
By default, Puppet Server is configured to use 2GB of RAM. However, if you want to experiment with Puppet Server on a VM, you can safely allocate as little as 512MB of memory. To change the Puppet Server memory allocation, you can edit the init config file.
/etc/sysconfig/puppetserver
/etc/default/puppetserver
In your settings, update the line:
# Modify this if you'd like to change the memory allocation, enable JMX, etc
JAVA_ARGS="-Xms2g -Xmx2g"
Replace 2g with the amount of memory you want to allocate to Puppet Server. For example, to allocate 1GB of memory, use JAVA_ARGS="-Xms1g -Xmx1g"
; for 512MB, use JAVA_ARGS="-Xms512m -Xmx512m"
.
For more information about the recommended settings for the JVM, see Oracle’s docs on JVM tuning.
Restart the puppetserver
service after making any changes to this file.
Submit issues to our bug tracker.