---
name: "puppet-config"
section: "8"
platform: "linux"
package: "openvox"
version: "8.28.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/puppet-config"
---

# puppet-config(8)

Interact with OpenVox's settings.

## NAME

**puppet-config** - Interact with OpenVox's settings.

## SYNOPSIS

puppet config *action* \[--section SECTION\_NAME\]

## DESCRIPTION

This subcommand can inspect and modify settings from OpenVox'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', 'server', and 'agent'. 'Main' is the default, and is used by all OpenVox applications. Other sections can override 'main' values for specific applications -- the 'server' section affects Puppet Server, 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 an OpenVox 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 OpenVox's current settings.

  **SYNOPSIS**

-

  puppet config print \[--section SECTION\_NAME\] all \| *setting* \[*setting* ...\]

-

  **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 OpenVox'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 'server' configuration domain:

$ puppet config delete setting\_name --section server

**print**

Get puppet's runfile directory:

$ puppet config print rundir

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

$ puppet config print all --section server \| grep -E "(path\|dir)"

**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., Vox Pupuli Apache 2 license; see COPYING