Docker registry WebUI and Authorization with Portus

Portus is an open source WebUI, Rails application that performs authentication and authorization for the Docker registry and a user interface for the image list, users, team, Registry and Namespace information. Portus provides quick access to all the images available on your private instance of Docker registry with OAuth and OpenID-Connect authentication.

portus Docker Registry WebUI

portus Docker Registry WebUI

Top Highlights

  • Monitoring of all the activities performed onto your private registry and Portus itself.
  • Search for repositories and tags inside of your private registry.
  • Removing images and tags from the registry through Portus.
  • Read Write access to the Docker registry.
  • Disable users temporarily, or remove them from the system.

Quick Portus Installation

There are multiple ways of setting up a development environment, we can install using docker-compose.

Install Docker Compose

# sudo curl -L$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose
# sudo chmod +x /usr/local/bin/docker-compose

Download Portus Repository

mkdir -p /opt/
git clone
cd Portus/examples/compose

You need to edit .env file and update following values:

Configure certificates

Update your SSL certificate


Start Portus

docker-compose up -d
docker-compose logs -f # watch the logs until finish installation.

Once all services started, you can browse the

It will ask to create an admin user and Configure the registry. Please note that you have to use same FQDN for adding registry in Portus. At the moment, they are supporting only one registry.  You can also try to install docker Private registry using native docker registry image.