{"id":16994724,"url":"https://github.com/znerol/python-podman-dump","last_synced_at":"2025-03-22T05:43:46.481Z","repository":{"id":41966489,"uuid":"451504532","full_name":"znerol/python-podman-dump","owner":"znerol","description":"A python script and a systemd unit simplifying data backups from podman containers","archived":false,"fork":false,"pushed_at":"2023-08-03T10:42:43.000Z","size":33,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-27T06:28:15.423Z","etag":null,"topics":["backup","podman","systemd"],"latest_commit_sha":null,"homepage":"https://podman-dump.readthedocs.org","language":"Python","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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-01-24T14:47:19.000Z","updated_at":"2024-02-26T02:43:22.000Z","dependencies_parsed_at":"2025-01-27T06:28:43.653Z","dependency_job_id":"b52c4943-079a-4a79-91fe-6c7745dd10db","html_url":"https://github.com/znerol/python-podman-dump","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/znerol%2Fpython-podman-dump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/znerol%2Fpython-podman-dump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/znerol%2Fpython-podman-dump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/znerol%2Fpython-podman-dump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/znerol","download_url":"https://codeload.github.com/znerol/python-podman-dump/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":["backup","podman","systemd"],"created_at":"2024-10-14T03:46:21.765Z","updated_at":"2025-03-22T05:43:46.462Z","avatar_url":"https://github.com/znerol.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"podman-dump\n===========\n\nA python script and a systemd unit simplifying data backups from podman\ncontainers.\n\n\nDependencies\n------------\n\nPodman-dump requires `podman` und `Python \u003e= 3.6`.\n\nNote that `conmon` version \u003c 2.0.26 is affected by containers/conmon#236.\nUnfortunately, this bug affects `conmon` shipped in\n[Debian 11 (Bullseye)][conmon bullseye] as well as\n[Ubuntu 22.04 (Jammy Jellyfish][conmon jammy]).\n\nUse the `--conmon` flag of `podman-dump` to specify a more recent `conmon`\nversion to be used during dumps.\n\n[conmon bullseye]: https://packages.debian.org/bullseye/conmon\n[conmon jammy]: https://packages.ubuntu.com/jammy/conmon\n\nInstall\n-------\n\nNavigate to the releases page and pick the latest `podman-dump-dist.tar.gz`\ntarball. Copy it to the target machine and unpack it there.\n\n    $ scp dist/podman-dump-dist.tar.gz me@example.com:~\n    $ ssh me@example.com sudo tar -C /usr/local -xzf ~/podman-dump-dist.tar.gz\n\n\nBuild\n-----\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/podman-dump-dist.tar.gz me@example.com:~\n    $ ssh me@example.com sudo tar -C /usr/local -xzf ~:podman-dump-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\nAnnotations\n-----------\n\nAnnotate containers with the `ch.znerol.podman-dump` label in order to\nconfigure them for periodic backups. See the `podman-dump(1)` manpage for\ndetailed information.\n\n\nSystemd timers\n--------------\n\nEnable `podman-dump@.timer` with an instance name matching one of the interval\nshorthands supported by `systemd.time(7)`. E.g., in order to enable the weekly\nschedule in the systemd `system` scope, run the following command:\n\n```\nsystemctl enable --now podman-dump@weekly.timer\n```\n\nRefer to `podman-dump@.service(8)` manpage for detailed information.\n\n\nUsage\n-----\n\n```\nusage: podman-dump [-h] [-p] [-v] dumpdir schedule\nusage: podman-dump [-h] [-p] [-v] [--podman PODMAN] [--conmon CONMON] dumpdir schedule\n\npositional arguments:\n  dumpdir          The destination directory for container dumps\n  schedule         Name of the schedule to run\n\noptional arguments:\n  -h, --help       show this help message and exit\n  -p, --prune      Prune old backups after dumping a container\n  -v, --verbose    Turn on verbose logging\n  --podman PODMAN  Path of the podman binary\n  --conmon CONMON  Path of the conmon binary\n\n```\n\n\nLicense\n-------\n\n* [GPL-3 or later](https://www.gnu.org/licenses/gpl-3.0.en.html)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fznerol%2Fpython-podman-dump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fznerol%2Fpython-podman-dump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fznerol%2Fpython-podman-dump/lists"}