Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/atcol/docker-registry-ui

A web frontend/UI for easy private/local Docker Registry integration
https://github.com/atcol/docker-registry-ui

Last synced: 2 months ago
JSON representation

A web frontend/UI for easy private/local Docker Registry integration

Awesome Lists containing this project

README 

        
[![Build Status](https://travis-ci.org/atc-/docker-registry-ui.svg?branch=master)](https://travis-ci.org/atc-/docker-registry-web) [![Gitter chat](https://badges.gitter.im/atc-/docker-registry-web.png)](https://gitter.im/atc-/docker-registry-web)



This project is archived as it has not been maintained in years. There are alternatives as listed [here](https://www.cloudbees.com/blog/docker-guis).



Docker Registry UI

===================



A web UI for easy private/local Docker V1 or V2 Registry integration. 



Docker Registry UI is a mature, easy-to-use and fast web application for administering your Docker Registry through a sleek user interface. You can register one-to-many registries and then browse, search and delete images.



## Features



The application boasts the following features:



 * View all images for all registries (one to many)

 

 * Further info. page for images for inspection of config. etc

 

 * Pull copy/paste shortcuts



 * Delete images



 * Search for images



 * Containerized via [Docker](https://registry.hub.docker.com/u/atcol/docker-registry-ui/)

 

 * Custom deployment context (e.g. /reg-ui)



 * Read only mode for preventing registry configuration changes once running

 

 * Stateless application



## Demo



This project is containerized. You can run with docker right now by simply running:



	docker run -d -p 8080:8080 atcol/docker-registry-ui



and browsing to localhost:8080/.



## Dependencies



You need to have a running instance of `docker registry` that has a **search backend enabled**! See [this issue](https://github.com/atc-/docker-registry-web/issues/65#issuecomment-68060219) for further information.



## Statelessness



The app' requires registry configuration which can be supplied once the app's running, or through container environment

variables:



	docker run -d -p 8080:8080 -e REG1=http://dev:5000/v1/ -e REG2=http://prod/v1/ atcol/docker-registry-ui



which will run the application and automatically register two registries at the hosts `dev` and `prod` respectively,

both running API versions v1. You must provide URLs that include the API version. 



**Note:** don't use `localhost` in registry URLs! The host needs to be visible from inside the container, so `-e REG1=http://localhost/...` won't work because localhost will resolve to the container's IP. If registry is running on the host, then remember to use its IP: `172.17.42.1`.



## Volumes



The webapp's configuration data is stored inside the container in a H2 database under `/var/lib/h2/`. You can hold this data on the host machine using the `-v` flag:



	docker run -d -p 8080:8080 -v /some/data/dir:/var/lib/h2 atcol/docker-registry-ui



which survives container restarts.



You could also use the data-container pattern using `--volumes-from`:



	docker run -d -v /var/lib/h2 --name="registry_web_data" ubuntu



	docker run -d -p 8080:8080 --volumes-from=registry_web_data atcol/docker-registry-ui



Now all data will be kept in the `registry_web_data` container.



## Custom Deployment Context



You can deploy this container in a custom context as such:



`docker run -d -p 80:8080 -it -e APP_CONTEXT=ui -e REG1=http://172.17.42.1:5000/v1/ atcol/docker-registry-ui`



will expose the container under `http://localhost/ui`.



## Read Only Mode



Using the container parameter `-e READ_ONLY=true` will enable read only mode, which prevents manipulation of the 

registry configurations at runtime.



# License



As of release 0.9.5, this project is licenced under GPL v3.0. See the LICENSE file.



# Troubleshooting



## My registry can't be found/seen by docker registry web! Help!



If you're seeing error messages like `Connection to http://registry refused`, make sure you've configured the port and hostname correctly. **Do not** set the registry hostname to `localhost`, because the container will resolve this to itself (127.0.0.1). If the registry instance runs on the host machine (that which runs the container), then set the registry IP/hostname to `172.17.42.1`. Alternatively, you could use writable /etc/hosts as of Docker 1.2 and 'route' it that way.



## Registries behind HTTPS or `Ping failed: javax.net.ssl.SSLPeerUnverifiedException: peer not authenticated`

You need to register the CA with the container's keystore; see [this issue](https://github.com/atcol/docker-registry-ui/issues/108#issuecomment-74063947).