Increasing the ulimit for the PE services

This version is out of date. For current versions, see Puppet Enterprise support lifecycle.

The various services in PE require up to one file handle per connected client. On most OS configurations, the defaults will not be high enough for more than a couple hundred clients. To support more clients, you need to increase the number of allowed file handles.

You can increase the limits for the following services:

  • pe-orchestration-services
  • pe-puppetdb
  • pe-console-services
  • pe-puppetserver
  • pe-activemq
  • pe-puppet

In each of the following examples, replace <PE SERVICE> with the specific service you’re editing.

In addition, the “32768” limit can be changed as necessary.


With systemd, the number of open file handles allowed is controlled by a setting in the service file at /usr/lib/systemd/system/<PE SERVICE>.service. To increase the limit, run the following commands, setting the LimitNOFILEas needed:

mkdir /etc/systemd/system/<PE SERVICE>.service.d
echo "[Service]
 LimitNOFILE=32768" > /etc/systemd/system/<PE SERVICE>.service.d/limits.conf
systemctl daemon-reload

You can confirm the change by running the following command:

systemctl show <PE SERVICE> | grep LimitNOFILE


For RedHat and Ubuntu systems, the number of open file handles allowed for is controlled by settings in the following service files:

  • Ubuntu: /etc/default/<PE SERVICE>
  • RedHat: /etc/sysconfig/<PE SERVICE>

In both cases, set the last line of the file as follows:

ulimit -n 32678

This sets the number of open files allowed at 32,678.

other init systems

The ulimit controls the number of processes and file handles that the PE service user can open/process. To increase the ulimit for a PE service user, edit /etc/security/limits.conf so that it contains the following:

<PE SERVICE USER> soft nofile 32768
<PE SERVICE USER> hard nofile 32768
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.