Podman Container Configuration File: 5 Hidden Hacks

Estimated reading time: 5 minutes

Last updated on November 8th, 2024 at 05:46 pm

Podman is a container management engine providing simple daemonless and rootless container management opposite Docker. The identical CLI makes it easy for the developer to transition from the Docker to Podman as a better and more secure alternative.

Having the default values in place provides the best practices for running containers but that doesn’t restrict users to override that. With the Podman container configuration file, you can override these default values and control the container more.

Podman simply container management with the many default values that determine how Poaman will behave such aspects are storage defaults, network defaults, and strong security settings. Out of these settings make sure that allows running most of the container without any problem.

Let’s explore the Podman container configuration file and the available options.

Understand Podman Container Configuration File

What are Podman configuration files?

Podman container configuration file is how your container is created and how it will behave. When you install the Podman on your machine, it creates the default values that have the optimal settings.

When you run the container it will use this file to have the default settings for the container. The default path for the Podman container configuration is

/usr/share/containers/containers.conf 

with default settings.

You can check the default file for the Podman container configuration file.

FREE Podman Cheat Sheet (Everything You Need, In One Place)

This is the last Podman Cheat Sheet you’ll ever need. Why?
Because it’s not just a list of commands—it’s a shortcut to make your work easier, faster, and more effective.

Stop wasting time digging through documentation. With this cheat sheet, you’ll get exactly what you need, right when you need it.

Get the Cheat Sheet (FREE Access!)

Locating and Using Configuration

How can I override the Podman configuration file?

1. System-wide Defaults:

As an administrator, you can override the default Podman configuration file by creating a new file under the

/etc/containers/containers.conf

2. User-level Overrides:

For Podman normal users can further modify the Podman container configuration file with an additional path under your $HOME dir:

$HOME/.config/containers/containers.conf 

When you run the Podman container it will take all the values from these paths and merge them into a single Podman container configuration file.

3. Use the Environment Variable:

Podman provides the environment variable to override the default behavior of the Podman container configuration file CONTAINERS_CONF

This is helpful if you want to override temporary or use a specific configuration file per project.

CONTAINERS_CONF=/your/own/container.conf

Order of Precedence: Podman Container Configuration File

1. User $HOME dir configuration file values: $HOME/.config/containers/containers.conf
2. Administrator default values under /etc/containers/containers.conf
3. Podman default file /usr/share/containers/containers.conf

What is mentioned in the user configuration under $HOME override the Adminstrator file; that file overrides the default Podman container configuration file.

TIP: Podman use the default configuration file if no containers.conf file is found.

FREE Podman Cheat Sheet (Everything You Need, In One Place)

This is the last Podman Cheat Sheet you’ll ever need. Why?
Because it’s not just a list of commands—it’s a shortcut to make your work easier, faster, and more effective.

Stop wasting time digging through documentation. With this cheat sheet, you’ll get exactly what you need, right when you need it.

Get the Cheat Sheet (FREE Access!)

Types of Podman Container Configuration File

Podman provides five container configuration files that allow you to control the various settings with the Podman.

1. container.conf

File Location: /usr/share/containers/containers.conf

You can configure and modify the container configurations such as network and security settings, resource constraints, image storage location, and registry information.

2. storage.conf

File Location: /etc/containers/storage.conf

You can configure the storage-related settings in this file such as the storage driver and options for storing the container image and layers.

3. registries.conf

File Location: /etc/containers/registries.conf

You can specify the container image-related settings such as various image registries and search registries. You can specify the private and public registry other than the default Docker Hub and use a short alias name.

Podman Registry Unqualified Search Registries

4. mounts.conf

File Location: /usr/share/containers/mounts.conf

You can specify the default mount option that will be mounted when the container starts with the podman run and podman start command.

This is useful especially when you want to mount a default drive such as logs storage or a specific configuration directory inside all containers.

5. policy.json

File Location: /etc/containers/policy.json

You can use podman image trust the command to set the container image trust policy. Defining the policy.json your Podman setup allows you to set up the trust option that decides the container image that accepts and rejects the image.

{
  "default": [
    { "type": "accept" }
  ],
  "docker.io": [
    { "type": "signedBy", "keyPath": "/path/to/trusted_key.pub" }
  ]
}

FAQs:

FREE Podman Cheat Sheet (Everything You Need, In One Place)

This is the last Podman Cheat Sheet you’ll ever need. Why?
Because it’s not just a list of commands—it’s a shortcut to make your work easier, faster, and more effective.

Stop wasting time digging through documentation. With this cheat sheet, you’ll get exactly what you need, right when you need it.

Get the Cheat Sheet (FREE Access!)