Docker Registry Browser
Web Interface for the Docker Registry HTTP API V2 written in Ruby on Rails.
docker run --name registry-browser -it -p 8080:8080 -e DOCKER_REGISTRY_URL=http://your-registry:5000 klausmeyer/docker-registry-browser
- Install ruby e.g. using RVM (see
.ruby-versionfile for required version).
gem install bundler && bundle install --without development testinside your local clone of this repository
- Run the application using
DOCKER_REGISTRY_URL=http://your-registry:5000 bundle exec bundle exec puma -C config/puma.rb
The configuration is done by environment variables.
|DOCKER_REGISTRY_URL||yes||String||http://your-registry:5000||URL to the Docker Registry which should be browsed|
|NO_SSL_VERIFICATION||no||Bool||true||Enable to skip SSL verification (default
|BASIC_AUTH_USER||no||String||joe||Username for basic-auth against registry|
|BASIC_AUTH_PASSWORD||no||String||supersecretpassw0rd||Password for basic-auth against registry|
|ENABLE_DELETE_IMAGES||no||Bool||true||Allow deletion of tags (default
|PUBLIC_REGISTRY_URL||no||String||your-registry:5000||The public URL to the Docker Registry to do docker pull|
You can also set BASIC_AUTH_USER and BASIC_AUTH_PASSWORD as Docker Swarm secrets.
If you're using a reverse-proxy setup with SSL termination in front of this application in combination with
ENABLE_DELETE_IMAGES=true you must make sure that the application knows about this fact (by sending
X-Forwarded-Proto: https in the HTTP headers). Otherwise the application would throw errors like
"HTTP Origin header [...] didn't match request.base_url [...]" when you're trying to delete image-tags.