{"id":16994773,"url":"https://github.com/znerol/podluck","last_synced_at":"2026-05-19T09:32:37.187Z","repository":{"id":43938052,"uuid":"418520146","full_name":"znerol/podluck","owner":"znerol","description":"Podluck - Podman pods managed by systemd","archived":false,"fork":false,"pushed_at":"2022-02-13T13:57:06.000Z","size":44,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-27T06:28:22.168Z","etag":null,"topics":["podman","systemd"],"latest_commit_sha":null,"homepage":"https://podluck.readthedocs.org","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/znerol.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-10-18T13:44:50.000Z","updated_at":"2021-12-26T18:40:08.000Z","dependencies_parsed_at":"2022-09-09T18:44:46.880Z","dependency_job_id":null,"html_url":"https://github.com/znerol/podluck","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/znerol%2Fpodluck","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/znerol%2Fpodluck/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/znerol%2Fpodluck/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/znerol%2Fpodluck/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/znerol","download_url":"https://codeload.github.com/znerol/podluck/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244913005,"owners_count":20530769,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["podman","systemd"],"created_at":"2024-10-14T03:46:28.885Z","updated_at":"2026-05-19T09:32:37.138Z","avatar_url":"https://github.com/znerol.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Podluck - Podman pods managed by systemd\n\n[![CI](https://github.com/znerol/podluck/actions/workflows/ci.yml/badge.svg)](https://github.com/znerol/podluck/actions/workflows/ci.yml)\n\n`Podluck` is a set of systemd units designed to run podman pods in `system` or\nin `user` scope.\n\n`Podluck` units are an alternative to `podman generate-systemd --new`. The units\nare especially useful on systems deployed using configuration management. In\nthis situation it is often unpractical to spin up a pod with the sole purpose to\ngenerate units from it. With `podluck`, units can be prepared and shipped to\nhost systems for entirely new pods in a consistent manner (i.e., idempotent).\n\n\n## Installation\n\nNavigate to the releases page and pick the latest `podluck-dist.tar.gz` tarball.\nCopy it to the target machine and unpack it there.\n\n    $ scp dist/podluck-dist.tar.gz me@example.com:~\n    $ ssh me@example.com sudo tar -C /usr/local -xzf ~/podluck-dist.tar.gz\n\n\n## Build\n\n*Preferred method*: Build a distribution tarball, copy it to the target machine\nand unpack it there.\n\n    $ make dist\n    $ scp dist/podluck-dist.tar.gz me@example.com:~\n    $ ssh me@example.com sudo tar -C /usr/local -xzf ~:podluck-dist.tar.gz\n\n*Alternative method*: Check out this repository on the traget machine and\ninstall it directly. The destination directory can be changed with the `prefix`\nvariable in order to change the installation prefix to something else than\n`/usr/local`.\n\n    $ make all\n    $ sudo make prefix=/opt/local install\n\n[Sphinx] is necessary in order to build the man pages and the users guide. This\nstep can be skipped by using the `install-bin` target.\n\n[Sphinx]: https://www.sphinx-doc.org/\n\n\n## Ansible collection\n\nThe ansible collection [znerol.podluck] includes the `podluck` units and\nprovides modules and roles which simplify provisioning of `podman` pods.\n\n[znerol.podluck]: https://galaxy.ansible.com/znerol/podluck\n\n## Documentation\n\nSee [podluck.readthedocs.io] for more instructions and examples. Also the\nmanpages [podluck.service(8)] and [podluck@.service(8)] provide detailed\ninformation.\n\n[podluck.readthedocs.io]: https://podluck.readthedocs.io/en/latest/\n[podluck.service(8)]: https://podluck.readthedocs.io/en/latest/podluck.service.8.html\n[podluck@.service(8)]: https://podluck.readthedocs.io/en/latest/podluck@.service.8.html\n\n## Why this name?\n\nThe name `podluck` is derived from\n[Potluck]. The Potluck Dinner is a\ncommunity event where guests bring a dish for the benefit of all. This is an apt\nmetaphor for the microservice architecture where individual containers provide\nservices to form a useful application.\n\n[Potluck]: https://en.wikipedia.org/wiki/Potluck\n\n## License\n\n* [GPL-3 or later](https://www.gnu.org/licenses/gpl-3.0.en.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fznerol%2Fpodluck","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fznerol%2Fpodluck","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fznerol%2Fpodluck/lists"}