Skip to content
🐳 Web Interface for the Docker Registry HTTP API V2 written in Ruby on Rails.
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app
bin Rails 5.2 (#16) Jan 31, 2018
config release v1.1.1 Mar 15, 2019
db
docs
hooks
lib
log rails new -BOT Apr 23, 2016
public
spec support token auth against registry (#137) Mar 7, 2019
tmp update to rails 5.2.2.1 (#164) Mar 13, 2019
vendor/assets rails new -BOT Apr 23, 2016
.dockerignore
.gitignore
.rspec
.ruby-gemset
.ruby-version
.travis.yml
CHANGELOG.md
Dockerfile
Gemfile update to ruby 2.6.2 (#165) Mar 15, 2019
Gemfile.lock Update capybara to version 3.15.0 (#167) Mar 20, 2019
LICENSE
README.md
Rakefile
config.ru
docker-compose.yml
package.json update to rails 5.1.0.rc1 Mar 24, 2017

README.md

Docker Registry Browser

Build Status

Web Interface for the Docker Registry HTTP API V2 written in Ruby on Rails.

Screenshots

Repositories overview

Screenshot 1

Tag overview

Screenshot 2

Tag details

Screenshot 3

Delete tag

Screenshot 4

Usage

Docker

Execute:

docker run --name registry-browser -it -p 8080:8080 -e DOCKER_REGISTRY_URL=http://your-registry:5000 klausmeyer/docker-registry-browser

Manual setup

  1. Install ruby e.g. using RVM
    (see .ruby-version file for required version).
  2. Execute the following command inside your local clone of this repository:
    gem install bundler && bundle install --without development test
  3. Run the application using
    DOCKER_REGISTRY_URL=http://your-registry:5000 bundle exec bundle exec puma -C config/puma.rb

Configuration

The configuration is done by environment variables.

Option Required Type Description
DOCKER_REGISTRY_URL yes String URL to the Docker Registry which should be browsed
Example: http://your-registry:5000
NO_SSL_VERIFICATION no Bool Enable to skip SSL verification (default false)
Example: true
BASIC_AUTH_USER no String Username for basic-auth against registry
Example: joe
BASIC_AUTH_PASSWORD no String Password for basic-auth against registry
Example: supersecretpassw0rd
TOKEN_AUTH_USER no String Username for token-auth against registry
Example: joe
TOKEN_AUTH_PASSWORD no String Password for token-auth against registry
Example: supersecretpassw0rd
ENABLE_DELETE_IMAGES no Bool Allow deletion of tags (default false)
Example: true
PUBLIC_REGISTRY_URL no String The public URL to the Docker Registry to do docker pull
Example: your-registry:5000

You can also set the following variables as Docker Swarm secrets with the same naming:

  • BASIC_AUTH_USER
  • BASIC_AUTH_PASSWORD
  • TOKEN_AUTH_USER
  • TOKEN_AUTH_PASSWORD

Proxy Setups

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.

You can’t perform that action at this time.