conmon(8) System Manager's Manual conmon(8)
NAME
conmon - container monitor utility
SYNOPSIS
conmon [options]
DESCRIPTION
conmon is a command-line program for monitoring and managing the lifecy-
cle 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 termi-
nates 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 discon-
nects.
--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 shut-
down.
-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 con-
tainer.
-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 speci-
fied 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), buildah(1), cri-o(1), crun(8), runc(8)
HISTORY
October 2020, Originally compiled by Dan Walsh dwalsh@redhat.com
⟨mailto:dwalsh@redhat.com⟩
User Commands conmon(8)
Generated by dwww version 1.16 on Tue Dec 16 05:46:08 CET 2025.