pstauffer/docker-registry-frontend repository overview

⁠docker-registry-frontend

⁠Description

This is a simple frontend for the official docker-registry⁠. The idea was to create a readonly frontend to only display all available repositories and tags.

To get an overview, just checkout the screenshots⁠. At the moment are the following features implemented:

• List all repositories
• List all tags of a repository
• Show tag details

The application can be run as docker containter⁠ or as standalone application⁠.

⁠Run as Docker container

This application is automated build and available on docker hub⁠.

⁠Preparation

Change the environment variable REGISTRY_URL in the docker-compose.yml file.

REGISTRY_URL=https://docker-registry.example.com

### Base URL This setting is optional, but if you need to set a base_url with a specified path for your docker-registry frontend, use the variable FRONTEND_URL.

FRONTEND_URL=https://registry.example.com/frontend

### Basic Authentication

If the docker registry has basic authentication activated, you have to set the following environment variables in the docker-compose.yml file.

REGISTRY_AUTH=True
REGISTRY_USER=<user>
REGISTRY_PW=<password>

⁠Run Container

This will run the frontend application and a proxy container, which will forward your request to the application:

docker-compose up -d

After you've started the containers, the application is available on port 80.

⁠Debugging

docker-compse logs

⁠Run as standalone application

⁠virtualenv

# install virtualenv and dependencies
virtualenv .venv
source .venv/bin/activate
pip install -r requirements.txt

# set registry url
export REGISTRY_URL=https://docker-registry.example.com

# run application
python app.py

## To Do

• Docs> How to run as standalone app (also with virtualenv)
• Docs> Link to official docker-compose docu
• Docs> How to run without docker-compose
• Feature> Add a configuration file
• Bugfix> Change port, not 5000 (conflict with docker-registry)
• Tests> Is it needed to expose the app port (maybe for the nginx container?!)
• Tests> Basic Auth as Container & Standalone App

⁠Informations

• Docker API⁠

⁠Screenshots

Here are some screenshots to get an overview about the docker-registry frontend.

⁠License

This project is licensed under MIT⁠.