Collection with some of my Quadlet configuration files, or modifications of configurations found on the internet.

Feel free to contribute if you wrote a better implementation, some things like podman secrets may not have been added yet.

• Crafty View ↗
• Nextcloud (Apache) View ↗
• Nextcloud (Caddy) View ↗
• Pterodactyl View ↗
• Technitium View ↗
• Wireguard-Easy View ↗

1. The default quadlet container directory for a rootless system is ~/.config/containers/systemd/. Place all files from the container/pod in that directory. When running a rootful container, place them in a corresponding system-wide directory, like /etc/containers

2. Look in the container directory's README file for additional configuration steps and follow them.

3. Reload the systemd daemon with systemctl --user daemon-reload, or when running podman as root: sudo systemctl daemon-reload

4. Start the service by running systemctl --user start container-name.service. When there are multiple container files, run the one ending with -pod. When running podman as root, run sudo systemctl start container-name.service instead. If the services don't show up, try the steps in Debugging Podman Quadlets

5. If necessary, open the services' ports in your firewall. With firewalld (default on RHEL-based distributions) this is done with firewall-cmd using --add-service= or --add-port= with --permanent

When quadlets aren't showing up in systemctl when trying to run them, it's possible to show the errors by doing a dry run:

/usr/libexec/podman/quadlet -dryrun -user

Omit -user when parsing rootful services

With a user that has permissions to view logs, look at the journald logs:

journalctl -xef _SYSTEMD_USER_UNIT=container-name.service

With running containers as root, replace _SYSTEMD_USER_UNIT with _SYSTEMD_UNIT

View the podman runtime logs like below. If there's not enough information try the instructions above for more detailed logs

podman logs container_name

podman-systemd.unit - systemd units using Podman Quadlet

Make systemd better for Podman with Quadlet - Red Hat

You're free to use any of these configurations however you like