Man Page: puppet master

NAME

puppet-master - The puppet master daemon

SYNOPSIS

The central puppet server. Functions as a certificate authority by default.

USAGE

DESCRIPTION

This command starts an instance of puppet master, running as a daemon and using Ruby's built-in Webrick webserver. Puppet master can also be managed by other application servers; when this is the case, this executable is not used.

OPTIONS

Note that any Puppet setting that's valid in the configuration file is also a valid long argument. For example, 'server' is a valid setting, so you can specify '--server servername' as an argument. Boolean settings translate into '--setting' and '--no-setting' pairs.

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

--daemonize

Send the process into the background. This is the default. (This is a Puppet setting, and can go in puppet.conf. Note the special 'no-' prefix for boolean settings on the command line.)

--no-daemonize

Do not send the process into the background. (This is a Puppet setting, and can go in puppet.conf. Note the special 'no-' prefix for boolean settings on the command line.)

--debug

Enable full debugging.

--help

Print this help message.

--logdest

Where to send log messages. Choose between 'syslog' (the POSIX syslog service), 'console', or the path to a log file. If debugging or verbosity is enabled, this defaults to 'console'. Otherwise, it defaults to 'syslog'.

A path ending with '.json' will receive structured output in JSON format. The log file will not have an ending ']' automatically written to it due to the appending nature of logging. It must be appended manually to make the content valid JSON.

--masterport

The port on which to listen for traffic. The default port is 8140. (This is a Puppet setting, and can go in puppet.conf.)

--verbose

Enable verbosity.

--version

Print the puppet version number and exit.

--compile

Compile a catalogue and output it in JSON from the puppet master. Uses facts contained in the $vardir/yaml/ directory to compile the catalog.

EXAMPLE

puppet master

DIAGNOSTICS

When running as a standalone daemon, puppet master accepts the following signals:

SIGHUP: Restart the puppet master server.
SIGINT and SIGTERM: Shut down the puppet master server.
SIGUSR2: Close file descriptors for log files and reopen them. Used with logrotate.

AUTHOR

Luke Kanies