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

# conmon(8)

container monitor utility

## NAME

conmon - container monitor utility

## SYNOPSIS

conmon \[options\]

## DESCRIPTION

conmon is a command-line program for monitoring and managing the lifecycle of Linux containers that follow the Open Container Initiative (OCI) format.

## APPLICATION OPTIONS

**--api-version** Conmon API version to use.

**-b**, **--bundle** Location of the OCI Bundle path.

**-c**, **--cid** Identification of Container.

**--exec-attach** Attach to an exec session.

**-e**, **--exec** Exec a command into a running container.

**--exec-process-spec** Path to the process spec for execution.

**--exit-command** Path to the program to execute when the container terminates its execution.

**--exit-command-arg** Additional arguments to pass to the exit command.  Can be specified multiple time.

**--exit-delay** Delay before invoking the exit command (in seconds).

**--exit-dir** Path to the directory where exit files are written.

**-h**, **--help** Show help options.

**-i**, **--stdin** Open up a pipe to pass stdin to the container.

This option tells conmon to setup the pipe regardless of whether there is a terminal connection.

**-l**, **--log-path** Path to store all stdout and stderr messages from the container.

**--leave-stdin-open** Leave stdin open when the attached client disconnects.

**--log-level** Print debug logs based on the log level.

**--log-size-max** Maximum size of the log file.

**--log-tag** Additional tag to use for logging.

**-n**, **--name** Container name.

**--no-new-keyring** Do not create a new session keyring for the container.

**--no-pivot** Do not use pivot\_root.

**--no-sync-log** Do not manually call sync on logs after container shutdown.

**-0**, **--persist-dir** Persistent directory for a container that can be used for storing container data.

**-p**, **--container-pidfile** PID file for the initial pid inside of the container.

**-P**, **--conmon-pidfile** PID file for the conmon process.

**-r**, **--runtime** Path to store runtime data for the container.

**--replace-listen-pid** Replace listen pid if set for oci-runtime pid.

**--restore** Restore a container from a checkpoint.

**--runtime-arg** Additional arguments to pass to the runtime. Can be specified multiple times.

**--runtime-opt** Additional options to pass to the restore or exec command. Can be specified multiple times.

**-s**, **--systemd-cgroup** Enable systemd cgroup manager, rather then use the cgroupfs directly.

**--socket-dir-path** Location of container attach sockets.

**--sync** Keep the main conmon process as its child by only forking once.

**--syslog** Log to syslog (use with cgroupfs cgroup manager).

**-t**, **--terminal** Allocate a pseudo-TTY. The default is false.

When set to true, conmon will allocate a pseudo-tty and attach  to  the standard  input of the container. This can be used, for example, to run a throwaway interactive shell. The default is false.

**-T**, **--timeout** Kill container after specified timeout in seconds.

**-u**, **--cuuid** Specify the Container UUID to use.

**--version** Print the version and exit.

## SEE ALSO

[podman(1)](/podman/1.md), [buildah(1)](/buildah/1.md), cri-o(1), crun(8), [runc(8)](/runc/8.md)

## HISTORY

October 2020, Originally compiled by Dan Walsh dwalsh@redhat.com ⟨mailto:dwalsh@redhat.com⟩