NAME

       puppet-config - Interact with Puppet's settings.

SYNOPSIS

       puppet config action [--section SECTION_NAME]

DESCRIPTION

       This  subcommand can inspect and modify settings from Puppet's 'puppet.conf' configuration
       file.       For       documentation       about       individual       settings,       see
       https://puppet.com/docs/puppet/latest/configuration.html.

OPTIONS

       Note  that  any  setting  that's  valid  in  the  configuration  file is also a valid long
       argument, although it may or may not be relevant  to  the  present  action.  For  example,
       server  and  run_mode  are  valid  settings,  so you can specify --server <servername>, or
       --run_mode <runmode> as an argument.

       See          the          configuration          file           documentation           at
       https://puppet.com/docs/puppet/latest/configuration.html  for  the full list of acceptable
       parameters. A commented list of all configuration options can also be generated by running
       puppet with --genconfig.

       --render-as FORMAT
              The format in which to render output. The most common formats are json, s (string),
              yaml, and console, but other options such as dot are sometimes available.

       --verbose
              Whether to log verbosely.

       --debug
              Whether to log debug information.

       --section SECTION_NAME
              The section of the puppet.conf configuration file to interact with.

              The three most commonly used sections are 'main', 'master', and 'agent'. 'Main'  is
              the  default,  and  is used by all Puppet applications. Other sections can override
              'main' values for specific applications --  the  'master'  section  affects  puppet
              master and puppet cert, and the 'agent' section affects puppet agent.

              Less  commonly  used  is  the 'user' section, which affects puppet apply. Any other
              section will be treated as the name of a legacy environment (a deprecated feature),
              and can only include the 'manifest' and 'modulepath' settings.

ACTIONS

       delete - Delete a Puppet setting.
              SYNOPSIS

              puppet config delete [--section SECTION_NAME] setting

              DESCRIPTION

              Deletes a setting from the specified section. (The default is the section 'main').

              NOTES

              By  default,  this  action  deletes  the  configuration  setting  from  the  'main'
              configuration domain. Use the '--section'  flags  to  delete  settings  from  other
              configuration domains.

       print - Examine Puppet's current settings.
              SYNOPSIS

              DESCRIPTION

              Prints the value of a single setting or a list of settings.

              This  action  is  a  replacement interface to the information available with puppet
              <subcommand> --configprint.

              NOTES

              By default, this action reads the general configuration in the 'main' section.  Use
              the '--section' and '--environment' flags to examine other configuration domains.

       set - Set Puppet's settings.
              SYNOPSIS

              puppet config set [--section SECTION_NAME] [setting_name] [setting_value]

              DESCRIPTION

              Updates values in the puppet.conf configuration file.

              NOTES

              By  default,  this  action manipulates the configuration in the 'main' section. Use
              the '--section' flag to manipulate other configuration domains.

EXAMPLES

       delete

       Delete the setting 'setting_name' from the 'main' configuration domain:

       $ puppet config delete setting_name

       Delete the setting 'setting_name' from the 'master' configuration domain:

       $ puppet config delete setting_name --section master

       print

       Get puppet's runfile directory:

       $ puppet config print rundir

       Get a list of important directories from the master's config:

       set

       Set puppet's runfile directory:

       $ puppet config set rundir /var/run/puppetlabs

       Set the vardir for only the agent:

       $ puppet config set vardir /opt/puppetlabs/puppet/cache --section agent

COPYRIGHT AND LICENSE

       Copyright 2011 by Puppet Inc. Apache 2 license; see COPYING