routes.yaml: Advanced plugin routing


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 makes it possible to use certain extensions to Puppet, most notably PuppetDB. Usually you edit this file only to make changes that are explicitly specified by the setup instructions for an extension you 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 depends on your operating system. See the confdir documentation for details.


    terminus: puppetdb
    cache: yaml


The routes.yaml file is a YAML hash.

Each top level key is the name of a run mode (masteragent, or user), and its value is another hash.

Each key of the second-level hash is the name of an indirection, and its value is another hash.

The only keys allowed in the third-level hash are terminus and cache. The value of each of these keys is the name of a valid terminus for the indirection named above.

How helpful was this page?

If you leave us your email, we may contact you regarding your feedback. For more information on how Puppet uses your personal information, see our privacy policy.

Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.