https://github.com/tygoee/quadlets
My Quadlet configurations for Podman
https://github.com/tygoee/quadlets
podman podman-systemd quadlet
Last synced: 4 months ago
JSON representation
My Quadlet configurations for Podman
- Host: GitHub
- URL: https://github.com/tygoee/quadlets
- Owner: tygoee
- Created: 2025-04-27T18:45:33.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-03T18:56:48.000Z (5 months ago)
- Last Synced: 2026-01-04T02:56:26.936Z (5 months ago)
- Topics: podman, podman-systemd, quadlet
- Homepage:
- Size: 74.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Quadlets
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.
A part of the these containers has its installation automated with ansible, in my [ansibles repository](https://github.com/tygoee/ansibles)
## List of containers and pods
- DDClient [View ↗](./ddclient)
- Jellyfin [View ↗](./jellyfin)
- Nextcloud (Apache) [View ↗](./nextcloud-apache)
- Nextcloud (Caddy) [View ↗](./nextcloud-caddy)
- Portainer [View ↗](./portainer)
- Pterodactyl [View ↗](./pterodactyl)
- Technitium [View ↗](./technitium-dns)
### Unused/not updated containers and pods
- Crafty [View ↗](./crafty)
- WG-Easy [View ↗](./wg-easy)
## Installation instructions
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](https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html#podman-rootful-unit-search-path), like `/etc/containers`
2. Place the environment (.env) file(s) in `~/.config/containers/environment/` and modify them to your needs. If you need to place them in another directory, modify the container file(s) to point there.
> [!TIP]
> These common variables are templatable with Jinja2: `timezone` and `containername.(user,group,uid,gid,home)`
3. Look in the container directory's README file for additional configuration steps and follow them.
4. Reload the systemd daemon with `systemctl --user daemon-reload`, or when running podman as root: `sudo systemctl daemon-reload`
5. 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*
6. 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`
## Debugging Podman Quadlets
### Systemd generation fails
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:
```sh
/usr/libexec/podman/quadlet -dryrun -user
```
Omit `-user` when parsing rootful services
### Container fails to start
With a user that has permissions to view logs, look at the `journald` logs:
```sh
journalctl -xef _SYSTEMD_USER_UNIT=container-name.service
```
With running containers as root, replace `_SYSTEMD_USER_UNIT` with `_SYSTEMD_UNIT`
### Runtime podman logs
View the podman runtime logs like below. If there's not enough information try the instructions above for more detailed logs
```sh
podman logs container_name
```
## Quadlet documentation
[podman-systemd.unit - Podman documentation](https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html#podman-rootful-unit-search-path)
[Make systemd better for Podman with Quadlet](https://www.redhat.com/en/blog/quadlet-podman)
# License
You're free to use, share and redistribute any of these configuration files however you like. All documentation (markdown files) is licensed under the [CC-BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)