Add a Podman environment

When connecting a Podman host to Portainer, there are a few different methods you can use depending on your particular requirements. You can install the Portainer Agent on the Podman host and connect via the agent, you can connect directly to the Podman socket, or you can deploy the Portainer Edge Agent in standard or async mode.

Regardless of the method you choose, there are some generic requirements you will need to meet. You will require:

  • CentOS 9 with the latest version of Podman 5.x installed and working on your Podman host. Other Podman versions and Linux distros may work but we currently only support the above. We recommend following the official installation instructions for Podman.

  • sudo or root access on your Podman host.

The installation instructions also make the following assumptions about your environment:

  • Your environment meets our requirements. While Portainer may work with other configurations, it may require configuration changes or have limited functionality.

  • Podman is running as root. Portainer with rootless Podman may work but is currently not officially supported.

Last updated