Claim control of your

Docker images

Try out Portus View on GitHub Mailing list

What is Portus

Portus is an open source authorization service and user interface for the next generation Docker Registry.

Why use Portus

The Docker Hub is a wonderful place, but what if you cannot, or do not wish to push your images to a third party registry? You may setup a private instance of the Docker registry, but then everyone in your organization has push and pull privileges over all of your images.

How do you keep track of all of the images in your private registry?

Portus to the rescue!


Portus implements the new authorization scheme defined by the latest version of the Docker registry. It allows for fine grained control over all of your images. You decide which users and teams are allowed to push or pull images.

Easily manage users with teams

Map your company organization inside of Portus, define as many teams as you want and add and remove users from them.

Teams have three different types of users to allow full granularity:


Can only pull images.


Can push and pull images.


Like contributors, but can also add and remove users from the team.


Portus provides an intuitive overview of the contents of your private registry. It also features a search capability to find images even faster.

User privileges are constantly taken into account, even when browsing the contents of the repository or when performing searches.


Keep everything under control. All the relevant events are automatically logged by Portus and are available for analysis by admin users.

Non-admin users can also use this feature to keep up with relevant changes.

Try Portus

The docker-compose setup is suitable for development purposes, but it's also quite useful if you just want to try out Portus for the first time. Other than that, we have written quite some examples in the examples directory. These examples provide a wide variety of ways to deploy Portus in a production environment. Moreover, we have more guides in the "Setups" section of the user documentation.

The wiki contains the documentation for developers. The user documentation and the list of features contains the rest.

Feedback, comments, contributions?

Open an issue or subscribe to the Portus mailing list mailing list.