Config Files: puppetdb.conf

This version is out of date. For current versions, see Puppet packages and versions.

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 =
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.

See an issue? Please file a JIRA ticket in our [DOCUMENTATION] project
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.