{"id":13446796,"url":"https://github.com/pyouroboros/ouroboros","last_synced_at":"2025-05-15T03:07:41.193Z","repository":{"id":33987430,"uuid":"149199603","full_name":"pyouroboros/ouroboros","owner":"pyouroboros","description":"Automatically update running docker containers with newest available image","archived":false,"fork":false,"pushed_at":"2023-02-09T17:59:13.000Z","size":733,"stargazers_count":1592,"open_issues_count":46,"forks_count":157,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-04-14T04:58:58.829Z","etag":null,"topics":["container-management","containers","docker","docker-container","python-3","python3","update-checker","updater"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pyouroboros.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"custom":"https://buymeacoff.ee/ouroboros"}},"created_at":"2018-09-17T23:10:55.000Z","updated_at":"2025-04-08T12:30:19.000Z","dependencies_parsed_at":"2023-02-10T15:16:10.382Z","dependency_job_id":null,"html_url":"https://github.com/pyouroboros/ouroboros","commit_stats":{"total_commits":333,"total_committers":18,"mean_commits":18.5,"dds":0.4984984984984985,"last_synced_commit":"fee45f2dbf6eb3fc3ddab7473ca60df515aedc1f"},"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyouroboros%2Fouroboros","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyouroboros%2Fouroboros/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyouroboros%2Fouroboros/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyouroboros%2Fouroboros/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pyouroboros","download_url":"https://codeload.github.com/pyouroboros/ouroboros/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254264769,"owners_count":22041794,"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":["container-management","containers","docker","docker-container","python-3","python3","update-checker","updater"],"created_at":"2024-07-31T05:01:00.138Z","updated_at":"2025-05-15T03:07:36.176Z","avatar_url":"https://github.com/pyouroboros.png","language":"Python","funding_links":["https://buymeacoff.ee/ouroboros"],"categories":["Development with Docker","Python","python3","docker"],"sub_categories":["CI/CD"],"readme":"⚠️⚠️⚠️ ouroboros is no longer in development. It does its job (more or less) and the devs have succumb to real life! Please feel free to fork and maintain as you wish. We appreciate all of the support in the last year :). After support from the community, automated version bumps will continue to try to keep ouroboros in check with dependencies. ⚠️⚠️⚠️\n\u003cimg width=\"800\" src=\"https://raw.githubusercontent.com/pyouroboros/ouroboros/master/assets/ouroboros_logo_primary_long_cropped.jpg\" alt=\"Ouroboros Logo\"\u003e\n\n[![Discord](https://img.shields.io/discord/532695326117593112.svg?colorB=7289DA\u0026label=Discord\u0026logo=Discord\u0026logoColor=7289DA\u0026style=flat-square)](https://discord.gg/qHNByUW)\n[![Release](https://img.shields.io/github/release/pyouroboros/ouroboros.svg?style=flat-square)](https://hub.docker.com/r/pyouroboros/ouroboros/)\n[![Python Version](https://img.shields.io/pypi/pyversions/ouroboros-cli.svg?style=flat-square)](https://pypi.org/project/ouroboros-cli/)\n[![Docker Pulls](https://img.shields.io/docker/pulls/pyouroboros/ouroboros.svg?style=flat-square)](https://hub.docker.com/r/pyouroboros/ouroboros/)\n[![Layers](https://images.microbadger.com/badges/image/pyouroboros/ouroboros.svg)](https://microbadger.com/images/pyouroboros/ouroboros)  \n\nAutomatically update your running Docker containers to the latest available image.\n\nThe de-facto standard for docker update automation\n\n## Overview\n\nOuroboros will monitor (all or specified) running docker containers and update them to the (latest or tagged) available image in the remote registry. The updated container uses the same tag and parameters that were used when the container was first created such as volume/bind mounts, docker network connections, environment variables, restart policies, entrypoints, commands, etc.\n\n- Push your image to your registry and simply wait your defined interval for ouroboros to find the new image and redeploy your container autonomously.\n- Notify you via many platforms courtesy of [Apprise](https://github.com/caronc/apprise) \n- Serve metrics for trend monitoring (Currently: Prometheus/Influxdb)\n- Limit your server ssh access\n- `ssh -i key server.domainname \"docker pull ... \u0026\u0026 docker run ...\"` is for scrubs\n- `docker-compose pull \u0026\u0026 docker-compose up -d` is for fancier scrubs\n\n## Getting Started\n\nMore detailed usage and configuration can be found on [the wiki](https://github.com/pyouroboros/ouroboros/wiki).\n\n### Docker\n\nOuroboros is deployed via docker image like so:\n\n```bash\ndocker run -d --name ouroboros \\\n  -v /var/run/docker.sock:/var/run/docker.sock \\\n  pyouroboros/ouroboros\n```\n\n\u003e This is image is compatible for amd64, arm32, and arm64 CPU architectures\n\nor via `docker-compose`:\n\n[Official Example](https://github.com/pyouroboros/ouroboros/blob/master/docker-compose.yml)\n\n### Pip\n\nOuroboros can also be installed via `pip`:\n\n```bash\npip install ouroboros-cli\n```\n\nAnd can then be invoked using the `ouroboros` command:\n\n```bash\n$ ouroboros --interval 300 --log-level debug\n```\n\n\u003e This can be useful if you would like to create a `systemd` service or similar daemon that doesn't run in a container\n\n## Examples\nPer-command and scenario examples can be found in the [wiki](https://github.com/pyouroboros/ouroboros/wiki/Usage)\n\n## Contributing\n\nAll contributions are welcome! Contributing guidelines are in the works\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyouroboros%2Fouroboros","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpyouroboros%2Fouroboros","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyouroboros%2Fouroboros/lists"}