podman/docs/libpod.conf.5.md
Daniel J Walsh fbfcc7842e Add new field to libpod to indicate whether or not to use labelling
Also update some missing fields libpod.conf obtions in man pages.

Fix sort order of security options and add a note about disabling
labeling.

When a process requests a new label.  libpod needs to reserve all
labels to make sure that their are no conflicts.

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>

Closes: #1406
Approved by: mheon
2018-09-20 16:01:29 +00:00

2.1 KiB

% libpod.conf(5)

NAME

libpod.conf - libpod configuration file

DESCRIPTION

The libpod.conf file is the default configuration file for all tools using libpod to manage containers.

OPTIONS

image_default_transport="" Default transport method for pulling and pushing images

runtime_path="" Paths to search for a valid OCI runtime binary

conmon_path="" Paths to search for the Conmon container manager binary

conmon_env_vars="" Environment variables to pass into Conmon

cgroup_manager="" Specify the CGroup Manager to use; valid values are "systemd" and "cgroupfs"

static_dir="" Directory for persistent libpod files (database, etc) By default this will be configured relative to where containers/storage stores containers

tmp_dir="" Directory for temporary files Must be a tmpfs (wiped after reboot)

max_log_size="" Maximum size of log files (in bytes)

no_pivot_root="" Whether to use chroot instead of pivot_root in the runtime

cni_config_dir="" Directory containing CNI plugin configuration files

cni_plugin_dir="" Directories where CNI plugin binaries may be located

pause_image = "" Pause container image name for pod pause containers. When running a pod, we start a pause processes in a container to hold open the namespaces associated with the pod. This container and process, basically sleep/pause for the lifetime of the pod.

pause_command="" Command to run the pause container

namespace="" Default libpod namespace. If libpod is joined to a namespace, it will see only containers and pods that were created in the same namespace, and will create new containers and pods in that namespace. The default namespace is "", which corresponds to no namespace. When no namespace is set, all containers and pods are visible.

label="true|false" Indicates whether the containers should use label separation.

FILES

/usr/share/containers/libpod.conf, default libpod configuration path

/etc/containers/libpod.conf, override libpod configuration path

HISTORY

Apr 2018, Originally compiled by Nathan Williams nath.e.will@gmail.com