Puppet loads most of its settings from the puppet.conf
config file. You can edit this file directly, or you can change individual settings with the puppet config set
command.
Use puppet config set
for:
Fast one-off config changes,
Scriptable config changes in provisioning tools,
If you find yourself changing many settings, edit the puppet.conf
file instead, or manage it with a template.
Usage
sudo puppet config set <SETTING NAME> <VALUE> --section <CONFIG SECTION>
This declaratively sets the value of <SETTING NAME>
to <VALUE>
in the specified config section, regardless of whether the setting already had a value.
Config sections
The --section
option specifies which section of puppet.conf
to modify. It is optional, and defaults to main
. Valid sections are:
main
(default) — used by all commands and servicesmaster
— used by the Puppet master service and thepuppetserver ca
commandagent
— used by the Puppet agent serviceuser
— used by thepuppet apply
command and most other commands
When modifying the system config file, use sudo
or run the command as root
or Administrator.
Example
puppet.conf
file: [main]
certname = agent01.example.com
server = master.example.com
vardir = /var/opt/lib/pe-puppet
[agent]
report = true
graph = true
pluginsync = true
[master]
dns_alt_names = master,master.example.com,puppet,puppet.example.com
sudo puppet config set reports puppetdb --section master
sudo puppet config set ordering manifest
puppet.conf
file now looks like this: [main]
certname = agent01.example.com
server = master.example.com
vardir = /var/opt/lib/pe-puppet
ordering = manifest
[agent]
report = true
graph = true
pluginsync = true
[master]
dns_alt_names = master,master.example.com,puppet,puppet.example.com
reports = puppetdb