I’m looking to migrate all of my containers to rootless podman but need some advice.
All of my services are currently running docker compose. I’ve played arount with podman but I am unsure of best practice: I have the option of installing podman-docker, podman-compose, or docker-compose connected to a podman socket. What’s the recommended way here?
I also can’t seem to find any information on setting up a systemd unit for rootless podman compose. How are you all auto starting podman (compose) files?
Check out Podlet to convert your existing docker run commands or docker-compose.yaml files to quadlet files https://github.com/k9withabone/podlet
I run everything in rootless containers using systemd service files generated with
podman generate systemd
.Podman Compose is a “community effort”, and Red Hat seems to be less focused on its development (here is their post about it).
There are ways to get it working but I find it easier to go with podman containers and pods through systemd because the majority of documentation (both official and unofficial) leans in that direction.
I don’t know how much you already know, so here is just a summary of things that worked for me for anyone reading.
Podman uses the concept of “Pods” to link together associated containers and manage name spaces, networking, etc. The high level summary for running podman pods through systemd:
- Create an empty pod
podman pod create --name=<mypod>
. - Start containers using
podman run --pod=<mypod> ...
and reconfigure until containers are working within the same pod as desired. - Use podman generate systemd to create a set of systemd unit files. Be sure to read through the options in that man page. – this is more reliable than creating systemd unit files by hand because it creates unit files optimized for the podman workflow.
- place the generated systemd unit files in the right place (user vs. system) and then it can be started, enabled, and disabled as with other systemd unit files.
Note: for standalone containers that are not linked or reliant on other containers, you
canshould skip creating the empty pod and can skip the--pod=<mypod>
when starting containers. This should result in a single service file generated and that container will operate independently.This post goes over pods as systemd services.
This doc goes over containers as systemd services.
The Red Hat Enterprise Linux docs have a good amount of info, as well as their “sysadmin” series of posts.
Here are some harder to find things I’ve had to hunt down that might help with troubleshooting:
- Important: be sure to enable
loginctl enable-linger <username>
or else rootless pods/containers will stop when you log out of that session. - If you want it to run a container or pod at system startup you will need to specify the right parameters in the
[
section of the systemd file, see ]this doc page. Podman generate systemd should take care of this. - If you are using SELinux there is a package called
container-selinux
that has some useful booleans that can help with specific policies (container-use-devices
is a good one if your container needs access to a GPU or similar). Link to repo
- Create an empty pod