Config files: puppetdb.conf

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 documentation

If you’re using PuppetDB 3.0 or higher, puppetdb.conf is documented in the PuppetDB docs.

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 depends on your OS. 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.