Skip to content

docker-registry-web

docker-registry-web is a web user interface (UI) for a Docker Registry, specifically used to visualize and manage the container images stored within the registry server^[600-developer-docker-dockerfile-dockerfile-01.md]. It allows users to interact with the registry via a browser instead of solely relying on command-line tools like curl^[600-developer-docker-dockerfile-dockerfile-01.md].

Deployment

To utilize the web UI, docker-registry-web is typically deployed as a Docker container alongside the main registry service^[600-developer-docker-dockerfile-dockerfile-01.md].

The following steps outline how to set up the registry and its web interface:

  1. Start the Registry Server: First, run the official registry container (usually mapping port 5000).
    docker run -d -p 5000:5000 --name registry-srv registry:2
    
  2. Run the Web UI: Launch the web interface container, linking it to the registry server instance^[600-developer-docker-dockerfile-dockerfile-01.md].
    docker run -it -p 8080:8080 --name registry-web --link registry-srv -e REGISTRY_URL=http://registry-srv:5000/v2 -e REGISTRY_NAME=localhost:5000 hyper/docker-registry-web
    

Configuration

The application requires environment variables to establish a connection with the backend registry^[600-developer-docker-dockerfile-dockerfile-01.md].

  • REGISTRY_URL: Specifies the endpoint for the Docker Registry API (e.g., http://registry-srv:5000/v2)^[600-developer-docker-dockerfile-dockerfile-01.md].
  • REGISTRY_NAME: Defines the name or URL reference used within the UI (e.g., localhost:5000)^[600-developer-docker-dockerfile-dockerfile-01.md].

Sources

^[600-developer-docker-dockerfile-dockerfile-01.md]