---
name: "certmonger"
section: "8"
platform: "linux"
package: "certmonger"
version: "0.79.20-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/certmonger"
---

# certmonger(8)

## NAME

certmonger

## SYNOPSIS

certmonger \[-s\|-S\] \[-L\|-l\] \[-P PATH\] \[-b TIMEOUT\|-B\] \[-n\|-f\] \[-d LEVEL\] \[-p FILE\] \[-F\] \[-c command\] \[-v\]

## DESCRIPTION

The *certmonger* daemon monitors certificates for impending expiration, and can optionally refresh soon-to-be-expired certificates with the help of a CA.  If told to, it can drive the entire enrollment process from key generation through enrollment and refresh.

The daemon provides a control interface via the *org.fedorahosted.certmonger* service, with which client tools such as [**getcert**(1)](/getcert/1.md) interact.

## OPTIONS

- **-s**, **--session**

  Listen on the session bus rather than the system bus.

- **-S**, **--system**

  Listen on the system bus rather than the session bus.  This is the default.

- **-l**, **--listening-socket**

  Also listen on a private socket for connections from clients running under the same UID.

- **-L**, **--only-listening-socket**

  Listen only on a private socket for connections from clients running under the same UID, and skip connecting to a bus.

- **-P** *PATH*, **--listening-socket-path**=*PATH*

  Specify a location for the private listening socket.  If the location beings with a '/' character, it will be prefixed with 'unix:path=', otherwise it will be prefixed with 'unix:'.  If this option is not specified, the listening socket, if one is created, will be placed in the abstract namespace.

- **-b** *TIMEOUT*, --bus-activation-timeout**=***TIMEOUT*

  Behave as a bus-activated service: if there are no certificates to be monitored or obtained, and no requests are received within TIMEOUT seconds, exit.  Not compatible with the -c option.

- **-B**, **--no-bus-activation-timeout**

  Don't behave as a bus-activated service.  This is the default.

- **-n**, **--nofork**

  Don't fork, and log messages to stderr rather than syslog.

- **-f**, **--fork**

  Do fork, and log messages to syslog rather than stderr.  This is the default.

- **-d** *LEVEL*, **--debug-level**=*LEVEL*

  Set debugging level.  Higher values produce more debugging output.  Implies -n.

- **-p** *FILE*, **pidfile**=*FILE*

  Store the daemon's process ID in the named file.

- **-F**, **--fips**

  Force NSS to be initialized in FIPS mode.  The default behavior is to heed the setting stored in */proc/sys/crypto/fips\_enabled*.

- **-c** *COMMAND*, **--command**=*COMMAND*

  After the service has initialized, run the specified command, then shut down the service after the command exits.  If the -l or -L option was also specified, the command will be run with the *CERTMONGER\_PVT\_ADDRESS* environment variable set to the listening socket's location.  Not compatible with the -b option.

- **-v**, **--version**

  Print version information and exit.

## FILES

The set of certificates being monitored or signed is tracked using files stored under */var/lib/certmonger/requests*, or in a directory named by the *CERTMONGER\_REQUESTS\_DIR* environment variable.

The set of known CAs is tracked using files stored under */var/lib/certmonger/cas*, or in a directory named by the *CERTMONGER\_CAS\_DIR* environment variable.

Temporary files will be stored in "*/run/certmonger*", or in the directory named by the *CERTMONGER\_TMPDIR* environment variable if that value was not given at compile time.

## BUGS

Please file tickets for any that you find at https://fedorahosted.org/certmonger/

## SEE ALSO

[**getcert**(1)](/getcert/1.md) [**getcert-add-ca**(1)](/getcert-add-ca/1.md) [**getcert-add-scep-ca**(1)](/getcert-add-scep-ca/1.md) [**getcert-list-cas**(1)](/getcert-list-cas/1.md) [**getcert-list**(1)](/getcert-list/1.md) [**getcert-modify-ca**(1)](/getcert-modify-ca/1.md) [**getcert-refresh-ca**(1)](/getcert-refresh-ca/1.md) [**getcert-refresh**(1)](/getcert-refresh/1.md) [**getcert-rekey**(1)](/getcert-rekey/1.md) [**getcert-remove-ca**(1)](/getcert-remove-ca/1.md) [**getcert-request**(1)](/getcert-request/1.md) [**getcert-resubmit**(1)](/getcert-resubmit/1.md) [**getcert-start-tracking**(1)](/getcert-start-tracking/1.md) [**getcert-status**(1)](/getcert-status/1.md) [**getcert-stop-tracking**(1)](/getcert-stop-tracking/1.md) [**certmonger-certmaster-submit**(8)](/certmonger-certmaster-submit/8.md) [**certmonger-dogtag-ipa-renew-agent-submit**(8)](/certmonger-dogtag-ipa-renew-agent-submit/8.md) [**certmonger-dogtag-submit**(8)](/certmonger-dogtag-submit/8.md) [**certmonger-ipa-submit**(8)](/certmonger-ipa-submit/8.md) [**certmonger-local-submit**(8)](/certmonger-local-submit/8.md) [**certmonger-scep-submit**(8)](/certmonger-scep-submit/8.md) **certmonger\_selinux**(8)
