ec9957
% containers.conf 5 Container engine configuration file
bce470
bce470
# NAME
bce470
containers.conf - The container engine configuration file specifies default
bce470
configuration options and command-line flags for container engines.
bce470
bce470
# DESCRIPTION
bce470
Container engines like Podman & Buildah read containers.conf file, if it exists
bce470
and modify the defaults for running containers on the host. containers.conf uses
bce470
a TOML format that can be easily modified and versioned.
bce470
bce470
Container engines read the /usr/share/containers/containers.conf and
bce470
/etc/containers/containers.conf, and /etc/containers/containers.conf.d/*.conf files
ae5259
if they exist. When running in rootless mode, they also read
bce470
$HOME/.config/containers/containers.conf and
bce470
$HOME/.config/containers/containers.conf.d/*.conf files.
bce470
bce470
Fields specified in containers conf override the default options, as well as
bce470
options in previously read containers.conf files.
bce470
bce470
Config files in the `.d` directories, are added in alpha numeric sorted order and must end in `.conf`.
bce470
bce470
Not all options are supported in all container engines.
bce470
bce470
Note container engines also use other configuration files for configuring the environment.
bce470
bce470
* `storage.conf` for configuration of container and images storage.
bce470
* `registries.conf` for definition of container registires to search while pulling.
bce470
container images.
bce470
* `policy.conf` for controlling which images can be pulled to the system.
bce470
bce470
# FORMAT
bce470
The [TOML format][toml] is used as the encoding of the configuration file.
bce470
Every option is nested under its table. No bare options are used. The format of
bce470
TOML can be simplified to:
bce470
bce470
    [table1]
bce470
    option = value
bce470
bce470
    [table2]
bce470
    option = value
bce470
bce470
    [table3]
bce470
    option = value
bce470
bce470
    [table3.subtable1]
bce470
    option = value
bce470
bce470
## CONTAINERS TABLE
ae5259
The containers table contains settings to configure and manage the OCI runtime.
bce470
bce470
**annotations** = []
bce470
List of annotations. Specified as "key=value" pairs to be added to all containers.
bce470
bce470
Example: "run.oci.keep_original_groups=1"
bce470
bce470
**apparmor_profile**="container-default"
bce470
bce470
Used to change the name of the default AppArmor profile of container engines.
bce470
The default profile name is "container-default".
bce470
38a67a
**base_hosts_file**=""
38a67a
38a67a
The hosts entries from the base hosts file are added to the containers hosts
38a67a
file. This must be either an absolute path or as special values "image" which
38a67a
uses the hosts file from the container image or "none" which means
38a67a
no base hosts file is used. The default is "" which will use /etc/hosts.
38a67a
bce470
**cgroups**="enabled"
bce470
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
**cgroupns**="private"
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
**default_capabilities**=[]
bce470
bce470
List of default capabilities for containers.
bce470
bce470
The default list is:
bce470
```
bce470
default_capabilities = [
bce470
"AUDIT_WRITE",
bce470
      "CHOWN",
bce470
      "DAC_OVERRIDE",
bce470
      "FOWNER",
bce470
      "FSETID",
bce470
      "KILL",
bce470
      "MKNOD",
bce470
      "NET_BIND_SERVICE",
bce470
      "NET_RAW",
bce470
      "SETGID",
bce470
      "SETPCAP",
bce470
      "SETUID",
bce470
      "SYS_CHROOT",
bce470
]
bce470
```
bce470
bce470
**default_sysctls**=[]
bce470
bce470
A list of sysctls to be set in containers by default,
bce470
specified as "name=value".
bce470
bce470
Example:"net.ipv4.ping_group_range=0 1000".
bce470
bce470
**default_ulimits**=[]
bce470
bce470
A list of ulimits to be set in containers by default,
bce470
specified as "name=soft-limit:hard-limit".
bce470
bce470
Example: "nofile=1024:2048".
bce470
bce470
**devices**=[]
bce470
bce470
List of devices.
bce470
Specified as 'device-on-host:device-on-container:permissions'.
bce470
bce470
Example: "/dev/sdc:/dev/xvdc:rwm".
bce470
bce470
**dns_options**=[]
bce470
bce470
List of default DNS options to be added to /etc/resolv.conf inside of the
bce470
container.
bce470
bce470
**dns_searches**=[]
bce470
bce470
List of default DNS search domains to be added to /etc/resolv.conf inside of
bce470
the container.
bce470
bce470
**dns_servers**=[]
bce470
bce470
A list of dns servers 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
bce470
**env**=["PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin", "TERM=xterm"]
bce470
bce470
Environment variable list for the container process, used for passing
bce470
environment variables to the container.
bce470
bce470
**env_host**=false
bce470
bce470
Pass all host environment variables into the container.
bce470
38a67a
**host_containers_internal_ip**=""
38a67a
38a67a
Set the ip for the host.containers.internal entry in the containers /etc/hosts
38a67a
file. This can be set to "none" to disable adding this entry. By default it
38a67a
will automatically choose the host ip.
38a67a
38a67a
NOTE: When using podman machine this entry will never be added to the containers
38a67a
hosts file instead the gvproxy dns resolver will resolve this hostname. Therefore
38a67a
it is not possible to disable the entry in this case.
38a67a
bce470
**http_proxy**=true
bce470
bce470
Default proxy environment variables will be passed into the container.
bce470
The environment variables passed in include:
bce470
`http_proxy`, `https_proxy`, `ftp_proxy`, `no_proxy`, and the upper case
bce470
versions of these. The `no_proxy` option is needed when host system uses a proxy
bce470
but container should not use proxy. Proxy environment variables specified for
bce470
the container in any other way will override the values passed from the host.
bce470
bce470
**init**=false
bce470
bce470
Run an init inside the container that forwards signals and reaps processes.
bce470
bce470
**init_path**="/usr/libexec/podman/catatonit"
bce470
bce470
Path to the container-init binary, which forwards signals and reaps processes
ae5259
within containers. Note that the container-init binary will only be used when
bce470
the `--init` for podman-create and podman-run is set.
bce470
38a67a
**ipcns**="shareable"
bce470
bce470
Default way to to create a IPC namespace for the container.
bce470
Options are:
38a67a
  `host`     Share host IPC Namespace with the container.
38a67a
  `none`     Create shareable IPC Namespace for the container without a private /dev/shm.
38a67a
  `private`  Create private IPC Namespace for the container, other containers are not allowed to share it.
38a67a
  `shareable` Create shareable IPC Namespace for the container.
bce470
bce470
**keyring**=true
bce470
bce470
Indicates whether the container engines create a kernel keyring for use within
bce470
the container.
bce470
bce470
**label**=true
bce470
bce470
Indicates whether the container engine uses MAC(SELinux) container separation via labeling. This option is ignored on disabled systems.
bce470
bce470
**log_driver**="k8s-file"
bce470
bce470
Logging driver for the container. Available options: `k8s-file` and `journald`.
bce470
bce470
**log_size_max**=-1
bce470
bce470
Maximum size allowed for the container's log file. Negative numbers indicate
bce470
that no size limit is imposed. If it is positive, it must be >= 8192 to
bce470
match/exceed conmon's read buffer. The file is truncated and re-opened so the
bce470
limit is never exceeded.
bce470
bce470
**log_tag**=""
bce470
ae5259
Default format tag for container log messages. This is useful for creating a specific tag for container log messages. Container log messages default to using the truncated container ID as a tag.
bce470
bce470
**netns**="private"
bce470
bce470
Default way to to create a NET namespace for the container.
bce470
Options are:
bce470
  `private` Create private NET Namespace for the container.
bce470
  `host`    Share host NET Namespace with the container.
bce470
  `none`    Containers do not use the network.
bce470
bce470
**no_hosts**=false
bce470
ae5259
Create /etc/hosts for the container. By default, container engines manage
bce470
/etc/hosts, automatically adding  the container's  own  IP  address.
bce470
bce470
**pidns**="private"
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
**pids_limit**=1024
bce470
bce470
Maximum number of processes allowed in a container. 0 indicates that no limit
bce470
is imposed.
bce470
bce470
**prepare_volume_on_create**=false
bce470
bce470
Copy the content from the underlying image into the newly created volume when the container is created instead of when it is started. If `false`, the container engine will not copy the content until the container is started. Setting it to `true` may have negative performance implications.
bce470
bce470
**seccomp_profile**="/usr/share/containers/seccomp.json"
bce470
bce470
Path to the seccomp.json profile which is used as the default seccomp profile
bce470
for the runtime.
bce470
bce470
**shm_size**="65536k"
bce470
bce470
Size of `/dev/shm`. The format is `<number><unit>`. `number` must be greater
bce470
than `0`.
bce470
Unit is optional and can be:
bce470
`b` (bytes), `k` (kilobytes), `m`(megabytes), or `g` (gigabytes).
bce470
If you omit the unit, the system uses bytes. If you omit the size entirely,
bce470
the system uses `65536k`.
bce470
bce470
**tz=**""
bce470
bce470
Set timezone in container. Takes IANA timezones as well as `local`, which sets the timezone in the container to match the host machine.
bce470
If not set, then containers will run with the time zone specified in the image.
bce470
bce470
Examples:
bce470
  `tz="local"`
bce470
  `tz="America/New_York"`
bce470
bce470
**umask**="0022"
bce470
bce470
Sets umask inside the container.
bce470
bce470
**userns**="host"
bce470
bce470
Default way to to create a USER namespace for the container.
bce470
Options are:
bce470
  `private` Create private USER Namespace for the container.
bce470
  `host`    Share host USER Namespace with the container.
bce470
bce470
**userns_size**=65536
bce470
bce470
Number of UIDs to allocate for the automatic container creation. UIDs are
bce470
allocated from the “container” UIDs listed in /etc/subuid & /etc/subgid.
bce470
bce470
**utsns**="private"
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
38a67a
**volumes**=[]
38a67a
38a67a
List of volumes.
38a67a
Specified as "directory-on-host:directory-in-container:options".
38a67a
38a67a
Example:  "/db:/var/lib/db:ro".
bce470
bce470
## NETWORK TABLE
bce470
The `network` table contains settings pertaining to the management of CNI
bce470
plugins.
bce470
ae5259
**network_backend**=""
ae5259
ae5259
Network backend determines what network driver will be used to set up and tear down container networks.
ae5259
Valid values are "cni" and "netavark".
ae5259
The default value is empty which means that it will automatically choose CNI or netavark. If there are
ae5259
already containers/images or CNI networks preset it will choose CNI.
ae5259
ae5259
Before changing this value all containers must be stopped otherwise it is likely that
ae5259
iptables rules and network interfaces might leak on the host. A reboot will fix this.
ae5259
ec9957
**cni_plugin_dirs**=[]
bce470
bce470
List of paths to directories where CNI plugin binaries are located.
bce470
ec9957
The default list is:
ec9957
```
ec9957
cni_plugin_dirs = [
ec9957
  "/usr/local/libexec/cni",
ec9957
  "/usr/libexec/cni",
ec9957
  "/usr/local/lib/cni",
ec9957
  "/usr/lib/cni",
ec9957
  "/opt/cni/bin",
ec9957
]
ec9957
```
ec9957
bce470
**default_network**="podman"
bce470
ae5259
The network name of the default network to attach pods to.
bce470
bce470
**default_subnet**="10.88.0.0/16"
bce470
ae5259
The subnet to use for the default network (named above in **default_network**).
bce470
If the default network does not exist, it will be automatically created the first time a tool is run using this subnet.
bce470
38a67a
**default_subnet_pools**=[]
38a67a
38a67a
DefaultSubnetPools is a list of subnets and size which are used to
38a67a
allocate subnets automatically for podman network create.
38a67a
It will iterate through the list and will pick the first free subnet
38a67a
with the given size. This is only used for ipv4 subnets, ipv6 subnets
38a67a
are always assigned randomly.
38a67a
38a67a
The default list is (10.89.0.0-10.255.255.0/24):
38a67a
```
38a67a
default_subnet_pools = [
38a67a
  {"base" = "10.89.0.0/16", "size" = 24},
38a67a
  {"base" = "10.90.0.0/15", "size" = 24},
38a67a
  {"base" = "10.92.0.0/14", "size" = 24},
38a67a
  {"base" = "10.96.0.0/11", "size" = 24},
38a67a
  {"base" = "10.128.0.0/9", "size" = 24},
38a67a
]
38a67a
```
38a67a
bce470
**network_config_dir**="/etc/cni/net.d/"
bce470
ae5259
Path to the directory where network configuration files are located.
ae5259
For the CNI backend the default is "/etc/cni/net.d" as root
ae5259
and "$HOME/.config/cni/net.d" as rootless.
ae5259
For the netavark backend "/etc/containers/networks" is used as root
ae5259
and "$graphroot/networks" as rootless.
bce470
38a67a
**dns_bind_port**=53
bce470
38a67a
Port to use for dns forwarding daemon with netavark in rootful bridge
38a67a
mode and dns enabled.
38a67a
Using an alternate port might be useful if other dns services should
38a67a
run on the machine.
bce470
bce470
## ENGINE TABLE
bce470
The `engine` table contains configuration options used to set up container engines such as Podman and Buildah.
bce470
bce470
**active_service**=""
bce470
bce470
Name of destination for accessing the Podman service. See SERVICE DESTINATION TABLE below.
bce470
bce470
**cgroup_manager**="systemd"
bce470
bce470
The cgroup management implementation used for the runtime. Supports `cgroupfs`
bce470
and `systemd`.
bce470
bce470
**conmon_env_vars**=[]
bce470
bce470
Environment variables to pass into Conmon.
bce470
bce470
**conmon_path**=[]
bce470
bce470
Paths to search for the conmon container manager binary. If the paths are
bce470
empty or no valid path was found, then the `$PATH` environment variable will be
bce470
used as the fallback.
bce470
bce470
The default list is:
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
    "/run/current-system/sw/bin/conmon",
bce470
]
bce470
```
bce470
bce470
**detach_keys**="ctrl-p,ctrl-q"
bce470
bce470
Keys sequence used for detaching a container.
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
**enable_port_reservation**=true
bce470
bce470
Determines whether the engine will reserve ports on the host when they are
bce470
forwarded to containers. When enabled, when ports are forwarded to containers,
bce470
they are held open by conmon 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
**env**=[]
bce470
ae5259
Environment variables to be used when running the container engine (e.g., Podman, Buildah). For example "http_proxy=internal.proxy.company.com".
bce470
Note these environment variables will not be used within the container. Set the env section under [containers] table,
bce470
if you want to set environment variables for the container.
bce470
ae5259
**events_logfile_path**=""
ae5259
ae5259
Define where event logs will be stored, when events_logger is "file".
ae5259
38a67a
**events_logfile_max_size**="1m"
38a67a
38a67a
Sets the maximum size for events_logfile_path.
38a67a
The unit can be b (bytes), k (kilobytes), m (megabytes) or g (gigabytes).
38a67a
The format for the size is `<number><unit>`, e.g., `1b` or `3g`.
38a67a
If no unit is included then the size will be in bytes.
38a67a
When the limit is exceeded, the logfile will be rotated and the old one will be deleted.
38a67a
If the maximumn size is set to 0, then no limit will be applied,
38a67a
and the logfile will not be rotated.
38a67a
bce470
**events_logger**="journald"
bce470
38a67a
The default method to use when logging events.  
38a67a
38a67a
The default method is different based on the platform that
38a67a
Podman is being run upon.  To determine the current value,
38a67a
use this command:
38a67a
38a67a
`podman info --format {{.Host.EventLogger}`
38a67a
38a67a
Valid values are: `file`, `journald`, and `none`.
bce470
ec9957
**helper_binaries_dir**=["/usr/libexec/podman", ...]
ec9957
ec9957
A is a list of directories which are used to search for helper binaries.
ec9957
ec9957
The default paths on Linux are:
ec9957
- `/usr/local/libexec/podman`
ec9957
- `/usr/local/lib/podman`
ec9957
- `/usr/libexec/podman`
ec9957
- `/usr/lib/podman`
ec9957
ec9957
The default paths on macOS are:
ec9957
- `/usr/local/opt/podman/libexec`
ec9957
-	`/opt/homebrew/bin`
ec9957
-	`/opt/homebrew/opt/podman/libexec`
ec9957
- `/usr/local/bin`
ec9957
-	`/usr/local/libexec/podman`
ec9957
-	`/usr/local/lib/podman`
ec9957
-	`/usr/libexec/podman`
ec9957
-	`/usr/lib/podman`
ec9957
ec9957
The default path on Windows is:
ec9957
- `C:\Program Files\RedHat\Podman`
ec9957
bce470
**hooks_dir**=["/etc/containers/oci/hooks.d", ...]
bce470
bce470
Path to the OCI hooks directories for automatically executed hooks.
bce470
bce470
**image_default_format**="oci"|"v2s2"|"v2s1"
bce470
bce470
Manifest Type (oci, v2s2, or v2s1) to use when pulling, pushing, building
bce470
container images. By default images pulled and pushed match the format of the
bce470
source image. Building/committing defaults to OCI.
bce470
Note: **image_build_format** is deprecated.
bce470
bce470
**image_default_transport**="docker://"
bce470
bce470
Default transport method for pulling and pushing images.
bce470
bce470
**image_parallel_copies**=0
bce470
bce470
Maximum number of image layers to be copied (pulled/pushed) simultaneously.
bce470
Not setting this field will fall back to containers/image defaults. (6)
bce470
38a67a
**image_volume_mode**="bind"
38a67a
38a67a
Tells container engines how to handle the builtin image volumes.
38a67a
38a67a
* bind: An anonymous named volume will be  created  and  mounted into the container.
38a67a
* tmpfs: The volume is mounted onto the container as a tmpfs, which allows the users to create content that disappears when the container is stopped.
38a67a
* ignore: All volumes are just ignored and no action is taken.
38a67a
bce470
**infra_command**="/pause"
bce470
ae5259
Infra (pause) container image command for pod infra containers. When running a
ae5259
pod, we start a `/pause` process in a container to hold open the namespaces
ae5259
associated with the pod. This container does nothing other then sleep,
ae5259
reserving the pods resources for the lifetime of the pod.
bce470
ae5259
**infra_image**=""
bce470
ae5259
Infra (pause) container image for pod infra containers. When running a
bce470
pod, we start a `pause` process in a container to hold open the namespaces
ae5259
associated with the pod. This container does nothing other then sleep,
ae5259
reserving the pods resources for the lifetime of the pod. By default container
ae5259
engines run a builtin container using the pause executable. If you want override
ae5259
specify an image to pull.
bce470
bce470
**lock_type**="shm"
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
ae5259
faster "shm" lock type. You may need to run "podman system renumber" after you
bce470
change the lock type.
bce470
bce470
**multi_image_archive**=false
bce470
ae5259
Allows for creating archives (e.g., tarballs) with more than one image. Some container engines, such as Podman, interpret additional arguments as tags for one image and hence do not store more than one image. The default behavior can be altered with this option.
bce470
bce470
**namespace**=""
bce470
bce470
Default engine namespace. If the engine is joined to a namespace, it will see
bce470
only containers and pods that were created in the same namespace, and will
ae5259
create new containers and pods in that namespace. The default namespace is "",
bce470
which corresponds to no namespace. When no namespace is set, all containers
bce470
and pods are visible.
bce470
bce470
**network_cmd_path**=""
bce470
bce470
Path to the slirp4netns binary.
bce470
38a67a
**network_cmd_options**=[]
bce470
bce470
Default options to pass to the slirp4netns binary.
bce470
ae5259
Valid options values are:
ae5259
38a67a
  - **allow_host_loopback=true|false**: Allow the slirp4netns to reach the host loopback IP (`10.0.2.2`). Default is false.
ae5259
  - **mtu=MTU**: Specify the MTU to use for this network. (Default is `65520`).
ae5259
  - **cidr=CIDR**: Specify ip range to use for this network. (Default is `10.0.2.0/24`).
38a67a
  - **enable_ipv6=true|false**: Enable IPv6. Default is true. (Required for `outbound_addr6`).
ae5259
  - **outbound_addr=INTERFACE**: Specify the outbound interface slirp should bind to (ipv4 traffic only).
ae5259
  - **outbound_addr=IPv4**: Specify the outbound ipv4 address slirp should bind to.
ae5259
  - **outbound_addr6=INTERFACE**: Specify the outbound interface slirp should bind to (ipv6 traffic only).
ae5259
  - **outbound_addr6=IPv6**: Specify the outbound ipv6 address slirp should bind to.
ae5259
  - **port_handler=rootlesskit**: Use rootlesskit for port forwarding. Default.
ae5259
  Note: Rootlesskit changes the source IP address of incoming packets to a IP address in the container network namespace, usually `10.0.2.100`. If your application requires the real source IP address, e.g. web server logs, use the slirp4netns port handler. The rootlesskit port handler is also used for rootless containers when connected to user-defined networks.
ae5259
  - **port_handler=slirp4netns**: Use the slirp4netns port forwarding, it is slower than rootlesskit but preserves the correct source IP address. This port handler cannot be used for user-defined networks.
bce470
bce470
**no_pivot_root**=false
bce470
bce470
Whether to use chroot instead of pivot_root in the runtime.
bce470
bce470
**num_locks**=2048
bce470
bce470
Number of locks available for containers and pods. Each created container or
ae5259
pod consumes one lock. The default number available is 2048. If this is
bce470
changed, a lock renumbering must be performed, using the
bce470
`podman system renumber` command.
bce470
38a67a
**pod_exit_policy**="continue"
38a67a
38a67a
Set the exit policy of the pod when the last container exits.  Supported policies are:
38a67a
38a67a
| Exit Policy        | Description                                                                 |
38a67a
| ------------------ | --------------------------------------------------------------------------- |
38a67a
| *continue*         | The pod continues running when the last container exits. Used by default.   |
38a67a
| *stop*             | The pod is stopped when the last container exits. Used in `play kube`.      |
38a67a
bce470
**pull_policy**="always"|"missing"|"never"
bce470
bce470
Pull image before running or creating a container. The default is **missing**.
bce470
bce470
- **missing**: attempt to pull the latest image from the registries listed in registries.conf if a local image does not exist. Raise an error if the image is not in any listed registry and is not present locally.
bce470
- **always**: pull the image from the first registry it is found in as listed in registries.conf. Raise an error if not found in the registries, even if the image is present locally.
bce470
- **never**: do not pull the image from the registry, use only the local version. Raise an error if the image is not present locally.
bce470
bce470
**remote** = false
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 `podman --remote=true` for access to the remote Podman service.
bce470
bce470
**runtime**=""
bce470
bce470
Default OCI specific runtime in runtimes that will be used by default. Must
bce470
refer to a member of the runtimes table. Default runtime will be searched for
bce470
on the system using the priority: "crun", "runc", "kata".
bce470
ae5259
**runtime_supports_json**=["crun", "runc", "kata", "runsc", "krun"]
bce470
bce470
The list of the OCI runtimes that support `--format=json`.
bce470
ae5259
**runtime_supports_kvm**=["kata", "krun"]
bce470
bce470
The list of OCI runtimes that support running containers with KVM separation.
bce470
ae5259
**runtime_supports_nocgroups**=["crun", "krun"]
bce470
bce470
The list of OCI runtimes that support running containers without CGroups.
bce470
ae5259
**image_copy_tmp_dir**="/var/tmp"
ae5259
ae5259
Default location for storing temporary container image content. Can be
ae5259
overridden with the TMPDIR environment variable. If you specify "storage", then
ae5259
the location of the container/storage tmp directory will be used. If set then it
ae5259
is the users responsibility to cleanup storage. Configure tmpfiles.d(5) to
ae5259
cleanup storage.
ae5259
ae5259
**service_timeout**=**5**
ae5259
ae5259
Number of seconds to wait without a connection  before the
ae5259
`podman system service` times out and exits
ae5259
bce470
**static_dir**="/var/lib/containers/storage/libpod"
bce470
bce470
Directory for persistent libpod files (database, etc).
bce470
By default this will be configured relative to where containers/storage
bce470
stores containers.
bce470
bce470
**stop_timeout**=10
bce470
bce470
Number of seconds to wait for container to exit before sending kill signal.
bce470
38a67a
**exit_command_delay**=300
38a67a
38a67a
Number of seconds to wait for the API process for the exec call before sending exit command mimicking the Docker behavior of 5 minutes (in seconds).
38a67a
bce470
**tmp_dir**="/run/libpod"
bce470
bce470
The path to a temporary directory to store per-boot container.
bce470
Must be a tmpfs (wiped after reboot).
bce470
bce470
**volume_path**="/var/lib/containers/storage/volumes"
bce470
bce470
Directory where named volumes will be created in using the default volume
bce470
driver.
bce470
By default this will be configured relative to where containers/storage store
bce470
containers. This convention is followed by the default volume driver, but may
bce470
not be by other drivers.
bce470
bce470
**chown_copied_files**=true
bce470
bce470
Determines whether file copied into a container will have changed ownership to
bce470
the primary uid/gid of the container.
bce470
ae5259
**compression_format**=""
ae5259
ae5259
Specifies the compression format to use when pushing an image. Supported values are: `gzip`, `zstd` and `zstd:chunked`.
ae5259
bce470
## SERVICE DESTINATION TABLE
bce470
The `service_destinations` table contains configuration options used to set up remote connections to the podman service for the podman API.
bce470
bce470
**[service_destinations.{name}]**
bce470
URI to access the Podman service
bce470
**uri="ssh://user@production.example.com/run/user/1001/podman/podman.sock"**
bce470
bce470
  Example URIs:
bce470
bce470
- **rootless local**  - unix://run/user/1000/podman/podman.sock
bce470
- **rootless remote** - ssh://user@engineering.lab.company.com/run/user/1000/podman/podman.sock
38a67a
- **rootful local**  - unix://run/podman/podman.sock
38a67a
- **rootful remote** - ssh://root@10.10.1.136:22/run/podman/podman.sock
bce470
bce470
**identity="~/.ssh/id_rsa**
bce470
bce470
Path to file containing ssh identity key
bce470
bce470
**[engine.volume_plugins]**
bce470
bce470
A table of all the enabled volume plugins on the system. Volume plugins can be
bce470
used as the backend for Podman named volumes. Individual plugins are specified
bce470
below, as a map of the plugin name (what the plugin will be called) to its path
bce470
(filepath of the plugin's unix socket).
bce470
bce470
bce470
## SECRET TABLE
bce470
The `secret` table contains settings for the configuration of the secret subsystem.
bce470
bce470
**driver**=file
bce470
bce470
Name of the secret driver to be used.
bce470
Currently valid values are:
bce470
  * file
bce470
  * pass
bce470
bce470
**[secrets.opts]**
bce470
bce470
The driver specific options object.
bce470
5ecb0d
## MACHINE TABLE
5ecb0d
The `machine` table contains configurations for podman machine VMs
5ecb0d
5ecb0d
**cpus**=1
5ecb0d
Number of CPU's a machine is created with.
5ecb0d
5ecb0d
**disk_size**=10
5ecb0d
5ecb0d
The size of the disk in GB created when init-ing a podman-machine VM
5ecb0d
ae5259
**image**=""
5ecb0d
5ecb0d
Default image used when creating a new VM using `podman machine init`.
ae5259
Options: On Linux/Mac, `testing`, `stable`, `next`. On Windows, the major
ae5259
version of the OS (e.g `35`). For all platforms you can alternatively specify
ae5259
a custom path or download URL to an image. The default is `testing` on
ae5259
Linux/Mac, and `35` on Windows.
5ecb0d
5ecb0d
**memory**=2048
5ecb0d
5ecb0d
Memory in MB a machine is created with.
5ecb0d
ae5259
**user**=""
ae5259
ae5259
Username to use and create on the podman machine OS for rootless container
ae5259
access. The default value is `user`. On Linux/Mac the default is`core`.
ae5259
38a67a
**volumes**=["$HOME:$HOME"]
38a67a
38a67a
Host directories to be mounted as volumes into the VM by default.
38a67a
Environment variables like $HOME as well as complete paths are supported for
38a67a
the source and destination. An optional third field `:ro` can be used to
38a67a
tell the container engines to mount the volume readonly.
38a67a
bce470
# FILES
bce470
bce470
**containers.conf**
bce470
bce470
Distributions often provide a `/usr/share/containers/containers.conf` file to
bce470
define default container configuration. Administrators can override fields in
bce470
this file by creating `/etc/containers/containers.conf` to specify their own
bce470
configuration. Rootless users can further override fields in the config by
bce470
creating a config file stored in the `$HOME/.config/containers/containers.conf` file.
bce470
bce470
If the `CONTAINERS_CONF` path environment variable is set, just
ae5259
this path will be used. This is primarily used for testing.
bce470
bce470
Fields specified in the containers.conf file override the default options, as
bce470
well as options in previously read containers.conf files.
bce470
bce470
**storage.conf**
bce470
bce470
The `/etc/containers/storage.conf` file is the default storage configuration file.
bce470
Rootless users can override fields in the storage config by creating
bce470
`$HOME/.config/containers/storage.conf`.
bce470
bce470
If the `CONTAINERS_STORAGE_CONF` path environment variable is set, this path
bce470
is used for the storage.conf file rather than the default.
bce470
This is primarily used for testing.
bce470
bce470
# SEE ALSO
ae5259
containers-storage.conf(5), containers-policy.json(5), containers-registries.conf(5), tmpfiles.d(5)
bce470
bce470
[toml]: https://github.com/toml-lang/toml