3f07b4
# The containers configuration file specifies all of the available configuration
3f07b4
# command-line options/flags for container engine tools like Podman & Buildah,
3f07b4
# but in a TOML format that can be easily modified and versioned.
3f07b4
3f07b4
# Please refer to containers.conf(5) for details of all configuration options.
3f07b4
# Not all container engines implement all of the options.
3f07b4
# All of the options have hard coded defaults and these options will override
3f07b4
# the built in defaults. Users can then override these options via the command
3f07b4
# line. Container engines will read containers.conf files in up to three
3f07b4
# locations in the following order:
3f07b4
#  1. /usr/share/containers/containers.conf
3f07b4
#  2. /etc/containers/containers.conf
3f07b4
#  3. $HOME/.config/containers/containers.conf (Rootless containers ONLY)
3f07b4
#  Items specified in the latter containers.conf, if they exist, override the
3f07b4
# previous containers.conf settings, or the default settings.
3f07b4
3f07b4
[containers]
3f07b4
3f07b4
# List of devices. Specified as
3f07b4
# "<device-on-host>:<device-on-container>:<permissions>", for example:
3f07b4
# "/dev/sdc:/dev/xvdc:rwm".
3f07b4
# If it is empty or commented out, only the default devices will be used
3f07b4
#
3f07b4
# devices = []
3f07b4
3f07b4
# List of volumes. Specified as
3f07b4
# "<directory-on-host>:<directory-in-container>:<options>", for example:
3f07b4
# "/db:/var/lib/db:ro".
3f07b4
# If it is empty or commented out, no volumes will be added
3f07b4
#
3f07b4
# volumes = []
3f07b4
3f07b4
# Used to change the name of the default AppArmor profile of container engine.
3f07b4
#
3f07b4
# apparmor_profile = "container-default"
3f07b4
3f07b4
# List of annotation. Specified as
3f07b4
# "key=value"
3f07b4
# If it is empty or commented out, no annotations will be added
3f07b4
#
3f07b4
# annotations = []
3f07b4
3f07b4
# Default way to to create a cgroup namespace for the container
3f07b4
# Options are:
3f07b4
# `private` Create private Cgroup Namespace for the container.
3f07b4
# `host`    Share host Cgroup Namespace with the container.
3f07b4
#
3f07b4
# cgroupns = "private"
3f07b4
3f07b4
# Control container cgroup configuration
3f07b4
# Determines  whether  the  container will create CGroups.
3f07b4
# Options are:
3f07b4
# `enabled`   Enable cgroup support within container
3f07b4
# `disabled`  Disable cgroup support, will inherit cgroups from parent
3f07b4
# `no-conmon` Container engine runs run without conmon
3f07b4
#
3f07b4
# cgroups = "enabled"
3f07b4
3f07b4
# List of default capabilities for containers. If it is empty or commented out,
3f07b4
# the default capabilities defined in the container engine will be added.
3f07b4
#
3f07b4
# default_capabilities = [
3f07b4
#    "AUDIT_WRITE",
3f07b4
#    "CHOWN",
3f07b4
#    "DAC_OVERRIDE",
3f07b4
#    "FOWNER",
3f07b4
#    "FSETID",
3f07b4
#    "KILL",
3f07b4
#    "MKNOD",
3f07b4
#    "NET_BIND_SERVICE",
3f07b4
#    "NET_RAW",
3f07b4
#    "SETGID",
3f07b4
#    "SETPCAP",
3f07b4
#    "SETUID",
3f07b4
#    "SYS_CHROOT",
3f07b4
# ]
3f07b4
3f07b4
# A list of sysctls to be set in containers by default,
3f07b4
# specified as "name=value",
3f07b4
# for example:"net.ipv4.ping_group_range = 0 1000".
3f07b4
#
3f07b4
# default_sysctls = [
3f07b4
#  "net.ipv4.ping_group_range=0 1000",
3f07b4
# ]
3f07b4
3f07b4
# A list of ulimits to be set in containers by default, specified as
3f07b4
# "<ulimit name>=<soft limit>:<hard limit>", for example:
3f07b4
# "nofile=1024:2048"
3f07b4
# See setrlimit(2) for a list of resource names.
3f07b4
# Any limit not specified here will be inherited from the process launching the
3f07b4
# container engine.
3f07b4
# Ulimits has limits for non privileged container engines.
3f07b4
#
3f07b4
# default_ulimits = [
3f07b4
#  "nofile"="1280:2560",
3f07b4
# ]
3f07b4
3f07b4
# List of default DNS options to be added to /etc/resolv.conf inside of the container.
3f07b4
#
3f07b4
# dns_options = []
3f07b4
3f07b4
# List of default DNS search domains to be added to /etc/resolv.conf inside of the container.
3f07b4
#
3f07b4
# dns_searches = []
3f07b4
3f07b4
# Set default DNS servers.
3f07b4
# This option can be used to override the DNS configuration passed to the
3f07b4
# container. The special value "none" can be specified to disable creation of
3f07b4
# /etc/resolv.conf in the container.
3f07b4
# The /etc/resolv.conf file in the image will be used without changes.
3f07b4
#
3f07b4
# dns_servers = []
3f07b4
3f07b4
# Environment variable list for the conmon process; used for passing necessary
3f07b4
# environment variables to conmon or the runtime.
3f07b4
#
3f07b4
# env = [
3f07b4
#    "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
3f07b4
# ]
3f07b4
3f07b4
# Pass all host environment variables into the container.
3f07b4
#
3f07b4
# env_host = false
3f07b4
3f07b4
# Path to OCI hooks directories for automatically executed hooks.
3f07b4
#
3f07b4
# hooks_dir = [
3f07b4
#     "/usr/share/containers/oci/hooks.d",
3f07b4
# ]
3f07b4
3f07b4
# Default proxy environment variables passed into the container.
3f07b4
# The environment variables passed in include:
3f07b4
# http_proxy, https_proxy, ftp_proxy, no_proxy, and the upper case versions of
3f07b4
# these. This option is needed when host system uses a proxy but container
3f07b4
# should not use proxy. Proxy environment variables specified for the container
3f07b4
# in any other way will override the values passed from the host.
3f07b4
#
3f07b4
# http_proxy = true
3f07b4
3f07b4
# Run an init inside the container that forwards signals and reaps processes.
3f07b4
#
3f07b4
# init = false
3f07b4
3f07b4
#  Container init binary, if init=true, this is the init binary to be used for containers.
3f07b4
#
3f07b4
# init_path = "/usr/libexec/podman/catatonit"
3f07b4
3f07b4
# Default way to to create an IPC namespace (POSIX SysV IPC) for the container
3f07b4
# Options are:
3f07b4
# `private` Create private IPC Namespace for the container.
3f07b4
# `host`    Share host IPC Namespace with the container.
3f07b4
#
3f07b4
# ipcns = "private"
3f07b4
3f07b4
# Flag tells container engine to whether to use container separation using
3f07b4
# MAC(SELinux)labeling or not.
3f07b4
# Flag is ignored on label disabled systems.
3f07b4
#
3f07b4
# label = true
3f07b4
3f07b4
# Logging driver for the container. Available options: k8s-file and journald.
3f07b4
#
3f07b4
# log_driver = "k8s-file"
3f07b4
3f07b4
# Maximum size allowed for the container log file. Negative numbers indicate
3f07b4
# that no size limit is imposed. If positive, it must be >= 8192 to match or
3f07b4
# exceed conmon's read buffer. The file is truncated and re-opened so the
3f07b4
# limit is never exceeded.
3f07b4
#
3f07b4
# log_size_max = -1
3f07b4
3f07b4
# Default way to to create a Network namespace for the container
3f07b4
# Options are:
3f07b4
# `private` Create private Network Namespace for the container.
3f07b4
# `host`    Share host Network Namespace with the container.
3f07b4
# `none`    Containers do not use the network
3f07b4
#
3f07b4
# netns = "private"
3f07b4
3f07b4
# Create /etc/hosts for the container.  By default, container engine manage
3f07b4
# /etc/hosts, automatically adding  the container's  own  IP  address.
3f07b4
#
3f07b4
# no_hosts = false
3f07b4
3f07b4
# Maximum number of processes allowed in a container.
3f07b4
#
3f07b4
# pids_limit = 2048
3f07b4
3f07b4
# Default way to to create a PID namespace for the container
3f07b4
# Options are:
3f07b4
# `private` Create private PID Namespace for the container.
3f07b4
# `host`    Share host PID Namespace with the container.
3f07b4
#
3f07b4
# pidns = "private"
3f07b4
3f07b4
# Path to the seccomp.json profile which is used as the default seccomp profile
3f07b4
# for the runtime.
3f07b4
#
3f07b4
# seccomp_profile = "/usr/share/containers/seccomp.json"
3f07b4
3f07b4
# Size of /dev/shm. Specified as <number><unit>.
3f07b4
# Unit is optional, values:
3f07b4
# b (bytes), k (kilobytes), m (megabytes), or g (gigabytes).
3f07b4
# If the unit is omitted, the system uses bytes.
3f07b4
#
3f07b4
# shm_size = "65536k"
3f07b4
3f07b4
# Default way to to create a UTS namespace for the container
3f07b4
# Options are:
3f07b4
# `private`        Create private UTS Namespace for the container.
3f07b4
# `host`    Share host UTS Namespace with the container.
3f07b4
#
3f07b4
# utsns = "private"
3f07b4
3f07b4
# Default way to to create a User namespace for the container
3f07b4
# Options are:
3f07b4
# `auto`        Create unique User Namespace for the container.
3f07b4
# `host`    Share host User Namespace with the container.
3f07b4
#
3f07b4
# userns = "host"
3f07b4
3f07b4
# Number of UIDs to allocate for the automatic container creation.
3f07b4
# UIDs are allocated from the "container" UIDs listed in
3f07b4
# /etc/subuid & /etc/subgid
3f07b4
#
3f07b4
# userns_size=65536
3f07b4
3f07b4
# The network table contains settings pertaining to the management of
3f07b4
# CNI plugins.
3f07b4
3f07b4
[network]
3f07b4
3f07b4
# Path to directory where CNI plugin binaries are located.
3f07b4
#
3f07b4
# cni_plugin_dirs = ["/usr/libexec/cni"]
3f07b4
3f07b4
# Path to the directory where CNI configuration files are located.
3f07b4
#
3f07b4
# network_config_dir = "/etc/cni/net.d/"
3f07b4
3f07b4
[engine]
3f07b4
3f07b4
# Cgroup management implementation used for the runtime.
3f07b4
# Valid options "systemd" or "cgroupfs"
3f07b4
#
3f07b4
# cgroup_manager = "systemd"
3f07b4
3f07b4
# Environment variables to pass into conmon
3f07b4
#
3f07b4
# conmon_env_vars = [
3f07b4
#        "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
3f07b4
# ]
3f07b4
3f07b4
# Paths to look for the conmon container manager binary
3f07b4
#
3f07b4
# conmon_path = [
3f07b4
#        "/usr/libexec/podman/conmon",
3f07b4
#        "/usr/local/libexec/podman/conmon",
3f07b4
#        "/usr/local/lib/podman/conmon",
3f07b4
#        "/usr/bin/conmon",
3f07b4
#        "/usr/sbin/conmon",
3f07b4
#        "/usr/local/bin/conmon",
3f07b4
#        "/usr/local/sbin/conmon"
3f07b4
# ]
3f07b4
3f07b4
# Specify the keys sequence used to detach a container.
3f07b4
# Format is a single character [a-Z] or a comma separated sequence of
3f07b4
# `ctrl-<value>`, where `<value>` is one of:
3f07b4
# `a-z`, `@`, `^`, `[`, `\`, `]`, `^` or `_`
3f07b4
#
3f07b4
# detach_keys = "ctrl-p,ctrl-q"
3f07b4
3f07b4
# Determines whether engine will reserve ports on the host when they are
3f07b4
# forwarded to containers. When enabled, when ports are forwarded to containers,
3f07b4
# ports are held open by as long as the container is running, ensuring that
3f07b4
# they cannot be reused by other programs on the host. However, this can cause
3f07b4
# significant memory usage if a container has many ports forwarded to it.
3f07b4
# Disabling this can save memory.
3f07b4
#
3f07b4
# enable_port_reservation = true
3f07b4
3f07b4
# Selects which logging mechanism to use for container engine events.
3f07b4
# Valid values are `journald`, `file` and `none`.
3f07b4
#
3f07b4
# events_logger = "journald"
3f07b4
3f07b4
# Default transport method for pulling and pushing for images
3f07b4
#
3f07b4
# image_default_transport = "docker://"
3f07b4
3f07b4
# Default command to run the infra container
3f07b4
#
3f07b4
# infra_command = "/pause"
3f07b4
3f07b4
# Infra (pause) container image name for pod infra containers.  When running a
3f07b4
# pod, we start a `pause` process in a container to hold open the namespaces
3f07b4
# associated with the  pod.  This container does nothing other then sleep,
3f07b4
# reserving the pods resources for the lifetime of the pod.
3f07b4
#
3f07b4
# infra_image = "k8s.gcr.io/pause:3.2"
3f07b4
3f07b4
# Specify the locking mechanism to use; valid values are "shm" and "file".
3f07b4
# Change the default only if you are sure of what you are doing, in general
3f07b4
# "file" is useful only on platforms where cgo is not available for using the
3f07b4
# faster "shm" lock type.  You may need to run "podman system renumber" after
3f07b4
# you change the lock type.
3f07b4
#
3f07b4
# lock_type** = "shm"
3f07b4
3f07b4
# Default engine namespace
3f07b4
# If engine is joined to a namespace, it will see only containers and pods
3f07b4
# that were created in the same namespace, and will create new containers and
3f07b4
# pods in that namespace.
3f07b4
# The default namespace is "", which corresponds to no namespace. When no
3f07b4
# namespace is set, all containers and pods are visible.
3f07b4
#
3f07b4
# namespace = ""
3f07b4
3f07b4
# Whether to use chroot instead of pivot_root in the runtime
3f07b4
#
3f07b4
# no_pivot_root = false
3f07b4
3f07b4
# Number of locks available for containers and pods.
3f07b4
# If this is changed, a lock renumber must be performed (e.g. with the
3f07b4
# 'podman system renumber' command).
3f07b4
#
3f07b4
# num_locks = 2048
3f07b4
3f07b4
# Whether to pull new image before running a container
3f07b4
# pull_policy = "missing"
3f07b4
3f07b4
# Directory for persistent engine files (database, etc)
3f07b4
# By default, this will be configured relative to where the containers/storage
3f07b4
# stores containers
3f07b4
# Uncomment to change location from this default
3f07b4
#
3f07b4
# static_dir = "/var/lib/containers/storage/libpod"
3f07b4
3f07b4
# Directory for temporary files. Must be tmpfs (wiped after reboot)
3f07b4
#
3f07b4
# tmp_dir = "/var/run/libpod"
3f07b4
3f07b4
# Directory for libpod named volumes.
3f07b4
# By default, this will be configured relative to where containers/storage
3f07b4
# stores containers.
3f07b4
# Uncomment to change location from this default.
3f07b4
#
3f07b4
# volume_path = "/var/lib/containers/storage/volumes"
3f07b4
3f07b4
# Default OCI runtime
3f07b4
#
3f07b4
# runtime = "runc"
3f07b4
3f07b4
# List of the OCI runtimes that support --format=json.  When json is supported
3f07b4
# engine will use it for reporting nicer errors.
3f07b4
#
3f07b4
# runtime_supports_json = ["crun", "runc", "kata"]
3f07b4
3f07b4
# List of the OCI runtimes that supports running containers without cgroups.
3f07b4
#
3f07b4
# runtime_supports_nocgroups = ["crun"]
3f07b4
3f07b4
# List of the OCI runtimes that supports running containers with KVM Separation.
3f07b4
#
3f07b4
# runtime_supports_kvm = ["kata"]
3f07b4
3f07b4
# Paths to look for a valid OCI runtime (runc, runv, kata, etc)
3f07b4
[engine.runtimes]
3f07b4
# runc = [
3f07b4
#        "/usr/bin/runc",
3f07b4
#        "/usr/sbin/runc",
3f07b4
#        "/usr/local/bin/runc",
3f07b4
#        "/usr/local/sbin/runc",
3f07b4
#        "/sbin/runc",
3f07b4
#        "/bin/runc",
3f07b4
#        "/usr/lib/cri-o-runc/sbin/runc",
3f07b4
# ]
3f07b4
3f07b4
# crun = [
3f07b4
#            "/usr/bin/crun",
3f07b4
#            "/usr/sbin/crun",
3f07b4
#            "/usr/local/bin/crun",
3f07b4
#            "/usr/local/sbin/crun",
3f07b4
#            "/sbin/crun",
3f07b4
#            "/bin/crun",
3f07b4
#            "/run/current-system/sw/bin/crun",
3f07b4
# ]
3f07b4
3f07b4
# kata = [
3f07b4
#            "/usr/bin/kata-runtime",
3f07b4
#            "/usr/sbin/kata-runtime",
3f07b4
#            "/usr/local/bin/kata-runtime",
3f07b4
#            "/usr/local/sbin/kata-runtime",
3f07b4
#            "/sbin/kata-runtime",
3f07b4
#            "/bin/kata-runtime",
3f07b4
#            "/usr/bin/kata-qemu",
3f07b4
#            "/usr/bin/kata-fc",
3f07b4
# ]
3f07b4
3f07b4
# Number of seconds to wait for container to exit before sending kill signal.
3f07b4
#stop_timeout = 10
3f07b4
3f07b4
# The [engine.runtimes] table MUST be the last entry in this file.
3f07b4
# (Unless another table is added)
3f07b4
# TOML does not provide a way to end a table other than a further table being
3f07b4
# defined, so every key hereafter will be part of [runtimes] and not the main
3f07b4
# config.