Public | Automated Build

Last pushed: 2 years ago
Short Description
Automatically cleans up stale docker images
Full Description

Docker image cleaner

This command looks for images that should be okay to clean up.

This tool honors semver versioning.


If you have go installed, then you can get the binary docker-image-cleaner
with the following command:

$ go get -u
usage: docker-image-cleaner [<flags>]

Clean up docker images that seem safe to remove.

  -h, --help                   Show context-sensitive help (also try --help-long
                               and --help-man).
  -x, --exclude=IMAGE:TAG ...  Leaf images to exclude specified by image:tag
      --delete-dangling        Delete dangling images
      --delete-leaf            Delete leaf images
  -d, --safety-duration=DUR    Don't delete any images created in the last DUR
      --version                Show application version.

It uses the normal Docker environment variables, so if docker info works,
then the cleaner should work.

As a container

I have made this available as a
as well.

$ docker run \
  --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \

In addition to :latest it should also have all versions since 4.0.2


This project uses Glide to vendor
its dependencies. This is needed because engine-api is such a fast moving

If you have Ruby installed, then you can just run
rake setup to install Glide and vendor its dependencies.

If not, then you can run:

$ go get -u
$ glide install

To build it, you can use rake or just use a normal go get install.


  • This is based on bobrik's
    Thank you very much for sharing, @bobrik!
  • @seh provided lots of help for programming in Go (yeah, it's my first
    go program) and for what we should be cleaning up.
  • Also stole some travis tricks from taskcluster/slugid-go. Thanks for
    figuring that out!
Docker Pull Command
Source Repository