Are you happy with your logging solution? Would you help us out by taking a 30-second survey? Click here


A utility to clean de-refrenced images from a docker registry

Subscribe to updates I use docker-registry-sweeper

Statistics on docker-registry-sweeper

Number of watchers on Github 0
Number of open issues 1
Main language Python
Average time to merge a PR 25 days
Open pull requests 1+
Closed pull requests 0+
Last commit over 1 year ago
Repo Created over 4 years ago
Repo Last Updated over 1 year ago
Size 30 KB
Organization / Authorrstudio
Page Updated
Do you use docker-registry-sweeper? Leave a review!
View docker-registry-sweeper activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating docker-registry-sweeper for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)



The docker-registry-sweeper is a command line utility to identify and remove unreferenced images from a docker registry. Currently, S3 backed registries are supported. Other backend storage drivers may be added in the future.

The principle of operation for the docker-registry-sweeper is a mark and sweep. On each run, all images and repositories are scanned, and graph of images and repositories is created. To avoid potential race conditions that are inherit to the way docker-registry works, the docker-registry-sweeper utilizes a multi pass mark and sweep. On the first pass, newly dereferenced images are written to a file. On subsequent passes, any image that remains dereferenced for a configurable amount of time will be removed.


docker-registry-sweeper -a 7d sweep

This will sweep the registry of any unreferenced images older then 7 days.


Setup Environment

# virtualenv is recommended
virtualenv path/to/virtualenv

source path/to/virtualenv/bin/activate

pip install -r requirements.txt
docker-registry-sweeper open pull requests (View All Pulls)
  • Switch to using boto3
docker-registry-sweeper list of languages used
Other projects in Python