Puppet 3.8 Reference Manual

The routes.yaml file overrides configuration settings involving indirector termini, and allows termini to be set in greater detail than puppet.conf allows.


The routes.yaml file works around config limitations in Puppet’s internals and makes it possible to use certain extensions to Puppet, most notably PuppetDB. Most users shouldn’t freely edit the file, and should only make changes that are explicitly recommended by the setup instructions for the extension they are trying to install.


The routes.yaml file is located at $confdir/routes.yaml by default. Its location is configurable with the route_file setting.

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


    terminus: puppetdb
    cache: yaml


The routes.yaml file should be a YAML hash.

  • Each top level key should be the name of a run mode (master, agent, or user), and its value should be another hash.
    • Each key of these second-level hashes should be the name of an indirection, and its value should be another hash.
      • The only keys allowed in these third-level hashes are terminus and cache. The value of each of these keys should be the name of a valid terminus for the indirection named above.
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.