---
name: "puppetserver"
section: "1"
platform: "linux"
package: "puppetserver"
version: "8.7.0-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/puppetserver"
---

# puppetserver(1)

Puppetserver main command

## NAME

puppetserver - Puppetserver main command

## SYNOPSIS

```
puppetserver (--help | --version)
puppetserver [command] <args>
```

## DESCRIPTION

**puppetserver** implements Puppet's server-side components for managing Puppet agents in a distributed, service-oriented architecture.

## OPTIONS

- **-h, --help**

  Show the help message and exit. At top level it only lists the commands. To display the help of a specific subcommand, add the **--help** flag *after* the said command name

- **-v, --version**

  Show the version number and exit

## COMMANDS

**puppetserver** has eight different commands:

- **ca *\<args\>* ...**

  Manage the Private Key Infrastructure for Puppet Server's built-in Certificate Authority

- **gem *\<args\>* ...**

  Install and manage gems that are isolated from system Ruby and are accessible only to Puppet Server.

- **ruby *\<args\>* ...**

  Run code in Puppet Server's JRuby interpreter.

- **irb *\<args\>* ...**

  Start an interactive REPL for the JRuby that Puppet Server uses.

- **foreground *\<args\>* ...**

  Start the Puppet Server as a foreground process.

- **prune *\<args\>* ...**

  Cleanup old files in the reportdir or bucketdir.

- **start *\<args\>* ...**

  Start the Puppet Server as a background process.

- **stop *\<args\>* ...**

  Stop the Puppet Server process.

- **reload *\<args\>* ...**

  Reload the Puppet Server process.

For more details on the commands, see their respective manual pages.

## BUGS

Bugs can be reported to your distribution's bug tracker or upstream at  \<https://github.com/puppetlabs/puppetserver/issues\>

## SEE ALSO

[**puppetserver-ca**(1)](/puppetserver-ca/1.md), [**puppetserver-gem**(1)](/puppetserver-gem/1.md), [**puppetserver-ruby**(1)](/puppetserver-ruby/1.md), [**puppetserver-irb**(1)](/puppetserver-irb/1.md), [**puppetserver-foreground**(1)](/puppetserver-foreground/1.md), [**puppetserver-prune**(1)](/puppetserver-prune/1.md)

## AUTHOR

Louis-Philippe Véronneau