bce470
# The containers configuration file specifies all of the available configuration
bce470
# command-line options/flags for container engine tools like Podman & Buildah,
bce470
# but in a TOML format that can be easily modified and versioned.
bce470
bce470
# Please refer to containers.conf(5) for details of all configuration options.
bce470
# Not all container engines implement all of the options.
bce470
# All of the options have hard coded defaults and these options will override
bce470
# the built in defaults. Users can then override these options via the command
bce470
# line. Container engines will read containers.conf files in up to three
bce470
# locations in the following order:
bce470
#  1. /usr/share/containers/containers.conf
bce470
#  2. /etc/containers/containers.conf
bce470
#  3. $HOME/.config/containers/containers.conf (Rootless containers ONLY)
bce470
#  Items specified in the latter containers.conf, if they exist, override the
bce470
# previous containers.conf settings, or the default settings.
bce470
bce470
[containers]
bce470
bce470
# List of annotation. Specified as
bce470
# "key = value"
bce470
# If it is empty or commented out, no annotations will be added
bce470
#
bce470
#annotations = []
bce470
bce470
# Used to change the name of the default AppArmor profile of container engine.
bce470
#
bce470
#apparmor_profile = "container-default"
bce470
bce470
# Default way to to create a cgroup namespace for the container
bce470
# Options are:
bce470
# `private` Create private Cgroup Namespace for the container.
bce470
# `host`    Share host Cgroup Namespace with the container.
bce470
#
bce470
#cgroupns = "private"
bce470
bce470
# Control container cgroup configuration
bce470
# Determines  whether  the  container will create CGroups.
bce470
# Options are:
bce470
# `enabled`   Enable cgroup support within container
bce470
# `disabled`  Disable cgroup support, will inherit cgroups from parent
bce470
# `no-conmon` Do not create a cgroup dedicated to conmon.
bce470
#
bce470
#cgroups = "enabled"
bce470
bce470
# List of default capabilities for containers. If it is empty or commented out,
bce470
# the default capabilities defined in the container engine will be added.
bce470
#
bce470
default_capabilities = [
bce470
    "NET_RAW",
bce470
  "CHOWN",
bce470
  "DAC_OVERRIDE",
bce470
  "FOWNER",
bce470
  "FSETID",
bce470
  "KILL",
bce470
  "NET_BIND_SERVICE",
bce470
  "SETFCAP",
bce470
  "SETGID",
bce470
  "SETPCAP",
bce470
  "SETUID",
bce470
  "SYS_CHROOT"
bce470
]
bce470
bce470
# A list of sysctls to be set in containers by default,
bce470
# specified as "name=value",
bce470
# for example:"net.ipv4.ping_group_range = 0 0".
bce470
#
bce470
default_sysctls = [
bce470
  "net.ipv4.ping_group_range=0 0",
bce470
]
bce470
bce470
# A list of ulimits to be set in containers by default, specified as
bce470
# "<ulimit name>=<soft limit>:<hard limit>", for example:
bce470
# "nofile=1024:2048"
bce470
# See setrlimit(2) for a list of resource names.
bce470
# Any limit not specified here will be inherited from the process launching the
bce470
# container engine.
bce470
# Ulimits has limits for non privileged container engines.
bce470
#
bce470
#default_ulimits = [
bce470
#  "nofile=1280:2560",
bce470
#]
bce470
bce470
# List of devices. Specified as
bce470
# "<device-on-host>:<device-on-container>:<permissions>", for example:
bce470
# "/dev/sdc:/dev/xvdc:rwm".
bce470
# If it is empty or commented out, only the default devices will be used
bce470
#
bce470
#devices = []
bce470
bce470
# List of default DNS options to be added to /etc/resolv.conf inside of the container.
bce470
#
bce470
#dns_options = []
bce470
bce470
# List of default DNS search domains to be added to /etc/resolv.conf inside of the container.
bce470
#
bce470
#dns_searches = []
bce470
bce470
# Set default DNS servers.
bce470
# This option can be used to override the DNS configuration passed to the
bce470
# container. The special value "none" can be specified to disable creation of
bce470
# /etc/resolv.conf in the container.
bce470
# The /etc/resolv.conf file in the image will be used without changes.
bce470
#
bce470
#dns_servers = []
bce470
bce470
# Environment variable list for the conmon process; used for passing necessary
bce470
# environment variables to conmon or the runtime.
bce470
#
bce470
#env = [
bce470
#  "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
bce470
#  "TERM=xterm",
bce470
#]
bce470
bce470
# Pass all host environment variables into the container.
bce470
#
bce470
#env_host = false
bce470
bce470
# Default proxy environment variables passed into the container.
bce470
# The environment variables passed in include:
bce470
# http_proxy, https_proxy, ftp_proxy, no_proxy, and the upper case versions of
bce470
# these. This option is needed when host system uses a proxy but container
bce470
# should not use proxy. Proxy environment variables specified for the container
bce470
# in any other way will override the values passed from the host.
bce470
#
bce470
#http_proxy = true
bce470
bce470
# Run an init inside the container that forwards signals and reaps processes.
bce470
#
bce470
#init = false
bce470
bce470
# Container init binary, if init=true, this is the init binary to be used for containers.
bce470
#
bce470
#init_path = "/usr/libexec/podman/catatonit"
bce470
bce470
# Default way to to create an IPC namespace (POSIX SysV IPC) for the container
bce470
# Options are:
bce470
# `private` Create private IPC Namespace for the container.
bce470
# `host`    Share host IPC Namespace with the container.
bce470
#
bce470
#ipcns = "private"
bce470
bce470
# keyring tells the container engine whether to create
bce470
# a kernel keyring for use within the container.
bce470
#
bce470
#keyring = true
bce470
bce470
# label tells the container engine whether to use container separation using
bce470
# MAC(SELinux) labeling or not.
bce470
# The label flag is ignored on label disabled systems.
bce470
#
bce470
#label = true
bce470
bce470
# Logging driver for the container. Available options: k8s-file and journald.
bce470
#
bce470
#log_driver = "k8s-file"
bce470
bce470
# Maximum size allowed for the container log file. Negative numbers indicate
bce470
# that no size limit is imposed. If positive, it must be >= 8192 to match or
bce470
# exceed conmon's read buffer. The file is truncated and re-opened so the
bce470
# limit is never exceeded.
bce470
#
bce470
#log_size_max = -1
bce470
bce470
# Specifies default format tag for container log messages.
bce470
# This is useful for creating a specific tag for container log messages.
bce470
# Containers logs default to truncated container ID as a tag.
bce470
#
bce470
#log_tag = ""
bce470
bce470
# Default way to to create a Network namespace for the container
bce470
# Options are:
bce470
# `private` Create private Network Namespace for the container.
bce470
# `host`    Share host Network Namespace with the container.
bce470
# `none`    Containers do not use the network
bce470
#
bce470
#netns = "private"
bce470
bce470
# Create /etc/hosts for the container.  By default, container engine manage
bce470
# /etc/hosts, automatically adding  the container's  own  IP  address.
bce470
#
bce470
#no_hosts = false
bce470
bce470
# Default way to to create a PID namespace for the container
bce470
# Options are:
bce470
# `private` Create private PID Namespace for the container.
bce470
# `host`    Share host PID Namespace with the container.
bce470
#
bce470
#pidns = "private"
bce470
bce470
# Maximum number of processes allowed in a container.
bce470
#
bce470
#pids_limit = 2048
bce470
bce470
# Copy the content from the underlying image into the newly created volume
bce470
# when the container is created instead of when it is started. If false,
bce470
# the container engine will not copy the content until the container is started.
bce470
# Setting it to true may have negative performance implications.
bce470
#
bce470
#prepare_volume_on_create = false
bce470
bce470
# Indicates the networking to be used for rootless containers
bce470
#
bce470
#rootless_networking = "slirp4netns"
bce470
bce470
# Path to the seccomp.json profile which is used as the default seccomp profile
bce470
# for the runtime.
bce470
#
bce470
#seccomp_profile = "/usr/share/containers/seccomp.json"
bce470
bce470
# Size of /dev/shm. Specified as <number><unit>.
bce470
# Unit is optional, values:
bce470
# b (bytes), k (kilobytes), m (megabytes), or g (gigabytes).
bce470
# If the unit is omitted, the system uses bytes.
bce470
#
bce470
#shm_size = "65536k"
bce470
bce470
# Set timezone in container. Takes IANA timezones as well as "local",
bce470
# which sets the timezone in the container to match the host machine.
bce470
#
bce470
#tz = ""
bce470
bce470
# Set umask inside the container
bce470
#
bce470
#umask = "0022"
bce470
bce470
# Default way to to create a User namespace for the container
bce470
# Options are:
bce470
# `auto`        Create unique User Namespace for the container.
bce470
# `host`    Share host User Namespace with the container.
bce470
#
bce470
#userns = "host"
bce470
bce470
# Number of UIDs to allocate for the automatic container creation.
bce470
# UIDs are allocated from the "container" UIDs listed in
bce470
# /etc/subuid & /etc/subgid
bce470
#
bce470
#userns_size = 65536
bce470
bce470
# Default way to to create a UTS namespace for the container
bce470
# Options are:
bce470
# `private`        Create private UTS Namespace for the container.
bce470
# `host`    Share host UTS Namespace with the container.
bce470
#
bce470
#utsns = "private"
bce470
bce470
# List of volumes. Specified as
bce470
# "<directory-on-host>:<directory-in-container>:<options>", for example:
bce470
# "/db:/var/lib/db:ro".
bce470
# If it is empty or commented out, no volumes will be added
bce470
#
bce470
#volumes = []
bce470
bce470
# The network table contains settings pertaining to the management of
bce470
# CNI plugins.
bce470
bce470
[secrets]
bce470
#driver = "file"
bce470
bce470
[secrets.opts]
bce470
#root = "/example/directory"
bce470
bce470
[network]
bce470
bce470
# Path to directory where CNI plugin binaries are located.
bce470
#
bce470
#cni_plugin_dirs = ["/usr/libexec/cni"]
bce470
bce470
# The network name of the default CNI network to attach pods to.
bce470
#
bce470
#default_network = "podman"
bce470
bce470
# The default subnet for the default CNI network given in default_network.
bce470
# If a network with that name does not exist, a new network using that name and
bce470
# this subnet will be created.
bce470
# Must be a valid IPv4 CIDR prefix.
bce470
#
bce470
#default_subnet = "10.88.0.0/16"
bce470
bce470
# Path to the directory where CNI configuration files are located.
bce470
#
bce470
#network_config_dir = "/etc/cni/net.d/"
bce470
bce470
[engine]
bce470
# Index to the active service
bce470
#
bce470
#active_service = production
bce470
bce470
# Cgroup management implementation used for the runtime.
bce470
# Valid options "systemd" or "cgroupfs"
bce470
#
bce470
#cgroup_manager = "systemd"
bce470
bce470
# Environment variables to pass into conmon
bce470
#
bce470
#conmon_env_vars = [
bce470
#  "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
bce470
#]
bce470
bce470
# Paths to look for the conmon container manager binary
bce470
#
bce470
#conmon_path = [
bce470
#  "/usr/libexec/podman/conmon",
bce470
#  "/usr/local/libexec/podman/conmon",
bce470
#  "/usr/local/lib/podman/conmon",
bce470
#  "/usr/bin/conmon",
bce470
#  "/usr/sbin/conmon",
bce470
#  "/usr/local/bin/conmon",
bce470
#  "/usr/local/sbin/conmon"
bce470
#]
bce470
bce470
# Specify the keys sequence used to detach a container.
bce470
# Format is a single character [a-Z] or a comma separated sequence of
bce470
# `ctrl-<value>`, where `<value>` is one of:
bce470
# `a-z`, `@`, `^`, `[`, `\`, `]`, `^` or `_`
bce470
#
bce470
#detach_keys = "ctrl-p,ctrl-q"
bce470
bce470
# Determines whether engine will reserve ports on the host when they are
bce470
# forwarded to containers. When enabled, when ports are forwarded to containers,
bce470
# ports are held open by as long as the container is running, ensuring that
bce470
# they cannot be reused by other programs on the host. However, this can cause
bce470
# significant memory usage if a container has many ports forwarded to it.
bce470
# Disabling this can save memory.
bce470
#
bce470
#enable_port_reservation = true
bce470
bce470
# Environment variables to be used when running the container engine (e.g., Podman, Buildah).
bce470
# For example "http_proxy=internal.proxy.company.com".
bce470
# Note these environment variables will not be used within the container.
bce470
# Set the env section under [containers] table, if you want to set environment variables for the container.
bce470
#
bce470
#env = []
bce470
bce470
# Selects which logging mechanism to use for container engine events.
bce470
# Valid values are `journald`, `file` and `none`.
bce470
#
bce470
#events_logger = "journald"
bce470
events_logger = "file"
bce470
bce470
# Path to OCI hooks directories for automatically executed hooks.
bce470
#
bce470
#hooks_dir = [
bce470
#  "/usr/share/containers/oci/hooks.d",
bce470
#]
bce470
bce470
# Manifest Type (oci, v2s2, or v2s1) to use when pulling, pushing, building
bce470
# container images. By default image pulled and pushed match the format of the
bce470
# source image. Building/committing defaults to OCI.
bce470
#
bce470
#image_default_format = ""
bce470
bce470
# Default transport method for pulling and pushing for images
bce470
#
bce470
#image_default_transport = "docker://"
bce470
bce470
# Maximum number of image layers to be copied (pulled/pushed) simultaneously.
bce470
# Not setting this field, or setting it to zero, will fall back to containers/image defaults.
bce470
#
bce470
#image_parallel_copies = 0
bce470
bce470
# Default command to run the infra container
bce470
#
bce470
#infra_command = "/pause"
bce470
bce470
# Infra (pause) container image name for pod infra containers.  When running a
bce470
# pod, we start a `pause` process in a container to hold open the namespaces
bce470
# associated with the  pod.  This container does nothing other then sleep,
bce470
# reserving the pods resources for the lifetime of the pod.
bce470
#
bce470
#infra_image = "k8s.gcr.io/pause:3.4.1"
bce470
infra_image = "registry.access.redhat.com/ubi8/pause"
bce470
bce470
# Specify the locking mechanism to use; valid values are "shm" and "file".
bce470
# Change the default only if you are sure of what you are doing, in general
bce470
# "file" is useful only on platforms where cgo is not available for using the
bce470
# faster "shm" lock type.  You may need to run "podman system renumber" after
bce470
# you change the lock type.
bce470
#
bce470
#lock_type** = "shm"
bce470
bce470
# Indicates if Podman is running inside a VM via Podman Machine.
bce470
# Podman uses this value to do extra setup around networking from the
bce470
# container inside the VM to to host.
bce470
#
bce470
#machine_enabled = false
bce470
bce470
# MultiImageArchive - if true, the container engine allows for storing archives
bce470
# (e.g., of the docker-archive transport) with multiple images.  By default,
bce470
# Podman creates single-image archives.
bce470
#
bce470
#multi_image_archive = "false"
bce470
bce470
# Default engine namespace
bce470
# If engine is joined to a namespace, it will see only containers and pods
bce470
# that were created in the same namespace, and will create new containers and
bce470
# pods in that namespace.
bce470
# The default namespace is "", which corresponds to no namespace. When no
bce470
# namespace is set, all containers and pods are visible.
bce470
#
bce470
#namespace = ""
bce470
bce470
# Path to the slirp4netns binary
bce470
#
bce470
#network_cmd_path = ""
bce470
bce470
# Default options to pass to the slirp4netns binary.
bce470
# For example "allow_host_loopback=true"
bce470
#
bce470
#network_cmd_options = []
bce470
bce470
# Whether to use chroot instead of pivot_root in the runtime
bce470
#
bce470
#no_pivot_root = false
bce470
bce470
# Number of locks available for containers and pods.
bce470
# If this is changed, a lock renumber must be performed (e.g. with the
bce470
# 'podman system renumber' command).
bce470
#
bce470
#num_locks = 2048
bce470
bce470
# Whether to pull new image before running a container
bce470
#
bce470
#pull_policy = "missing"
bce470
bce470
# Indicates whether the application should be running in remote mode. This flag modifies the
bce470
# --remote option on container engines. Setting the flag to true will default
bce470
# `podman --remote=true` for access to the remote Podman service.
bce470
#
bce470
#remote = false
bce470
bce470
# Default OCI runtime
bce470
#
bce470
#runtime = "crun"
bce470
runtime = "runc"
bce470
bce470
# List of the OCI runtimes that support --format=json.  When json is supported
bce470
# engine will use it for reporting nicer errors.
bce470
#
bce470
#runtime_supports_json = ["crun", "runc", "kata", "runsc"]
bce470
bce470
# List of the OCI runtimes that supports running containers with KVM Separation.
bce470
#
bce470
#runtime_supports_kvm = ["kata"]
bce470
bce470
# List of the OCI runtimes that supports running containers without cgroups.
bce470
#
bce470
#runtime_supports_nocgroups = ["crun"]
bce470
bce470
# Directory for persistent engine files (database, etc)
bce470
# By default, this will be configured relative to where the containers/storage
bce470
# stores containers
bce470
# Uncomment to change location from this default
bce470
#
bce470
#static_dir = "/var/lib/containers/storage/libpod"
bce470
bce470
# Number of seconds to wait for container to exit before sending kill signal.
bce470
#
bce470
#stop_timeout = 10
bce470
bce470
# map of service destinations
bce470
#
bce470
#[service_destinations]
bce470
#  [service_destinations.production]
bce470
#     URI to access the Podman service
bce470
#     Examples:
bce470
#       rootless "unix://run/user/$UID/podman/podman.sock" (Default)
bce470
#       rootfull "unix://run/podman/podman.sock (Default)
bce470
#       remote rootless ssh://engineering.lab.company.com/run/user/1000/podman/podman.sock
bce470
#       remote rootfull ssh://root@10.10.1.136:22/run/podman/podman.sock
bce470
#
bce470
#    uri = "ssh://user@production.example.com/run/user/1001/podman/podman.sock"
bce470
#    Path to file containing ssh identity key
bce470
#    identity = "~/.ssh/id_rsa"
bce470
bce470
# Directory for temporary files. Must be tmpfs (wiped after reboot)
bce470
#
bce470
#tmp_dir = "/run/libpod"
bce470
bce470
# Directory for libpod named volumes.
bce470
# By default, this will be configured relative to where containers/storage
bce470
# stores containers.
bce470
# Uncomment to change location from this default.
bce470
#
bce470
#volume_path = "/var/lib/containers/storage/volumes"
bce470
bce470
# Paths to look for a valid OCI runtime (crun, runc, kata, runsc, etc)
bce470
[engine.runtimes]
bce470
#crun = [
bce470
#  "/usr/bin/crun",
bce470
#  "/usr/sbin/crun",
bce470
#  "/usr/local/bin/crun",
bce470
#  "/usr/local/sbin/crun",
bce470
#  "/sbin/crun",
bce470
#  "/bin/crun",
bce470
#  "/run/current-system/sw/bin/crun",
bce470
#]
bce470
bce470
#kata = [
bce470
#  "/usr/bin/kata-runtime",
bce470
#  "/usr/sbin/kata-runtime",
bce470
#  "/usr/local/bin/kata-runtime",
bce470
#  "/usr/local/sbin/kata-runtime",
bce470
#  "/sbin/kata-runtime",
bce470
#  "/bin/kata-runtime",
bce470
#  "/usr/bin/kata-qemu",
bce470
#  "/usr/bin/kata-fc",
bce470
#]
bce470
bce470
#runc = [
bce470
#  "/usr/bin/runc",
bce470
#  "/usr/sbin/runc",
bce470
#  "/usr/local/bin/runc",
bce470
#  "/usr/local/sbin/runc",
bce470
#  "/sbin/runc",
bce470
#  "/bin/runc",
bce470
#  "/usr/lib/cri-o-runc/sbin/runc",
bce470
#]
bce470
bce470
#runsc = [
bce470
#  "/usr/bin/runsc",
bce470
#  "/usr/sbin/runsc",
bce470
#  "/usr/local/bin/runsc",
bce470
#  "/usr/local/sbin/runsc",
bce470
#  "/bin/runsc",
bce470
#  "/sbin/runsc",
bce470
#  "/run/current-system/sw/bin/runsc",
bce470
#]
bce470
bce470
[engine.volume_plugins]
bce470
#testplugin = "/run/podman/plugins/test.sock"
bce470
bce470
# The [engine.volume_plugins] table MUST be the last entry in this file.
bce470
# (Unless another table is added)
bce470
# TOML does not provide a way to end a table other than a further table being
bce470
# defined, so every key hereafter will be part of [volume_plugins] and not the
bce470
# main config.