Puppet 3.8 Reference Manual

The puppetdb.conf file configures how Puppet should connect to one or more PuppetDB servers. It is only used if you are using PuppetDB and have connected your Puppet master to it.

PuppetDB 2.3 and Earlier

The following description does not apply to PuppetDB 3.0 and later. If you’re using a newer version, see the PuppetDB docs instead, as the file format has changed.


The puppetdb.conf file is always located at $confdir/puppetdb.conf. Its location is not configurable.

The location of the confdir varies; it depends on the OS, Puppet distribution, and user account. See the confdir documentation for details.


server = puppetdb.example.com
port = 8081


The puppetdb.conf file uses the same INI-like format as puppet.conf, but only uses a [main] section and only has two settings:

  • The server setting must be set to the hostname of the PuppetDB server.
  • The port setting must be set to the port of the PuppetDB server.

See the PuppetDB manual for more information.

Back to top
The page rank or the 1 our of 5 rating a user has given the page.
The email address of the user submitting feedback.
The URL of the page being ranked/rated.