# Container Registry

> Harbor is an OCI container registry. It allows users to store and publish container images.

---

Site [llms.txt](/llms.txt)

---

We manage a Container Registry for the Uni Cloud Münster using the open source registry [Harbor](https://goharbor.io/).

The registry is capable of storing Docker Images as well as Helm Charts and can also be used as a proxy to several docker registries, like [Docker Hub](https://hub.docker.com/).

It is accessible at the URL https://harbor.uni-muenster.de.

## Projects and Quotas

You can create new projects and use them as you like, but there is a strict quota on the storage of each project. If the storage is not sufficient, please send a short mail to cloud@uni-muenster.de with a reason why an increased quota is needed.

## Using the Proxy

We manage several proxies to the most common docker registries, like [Docker Hub](https://hub.docker.com/) or [Quay](https://quay.io/).
The names of the proxy projects start with `proxy-` and should be self explanatory.

To use one of those proxies, simply find the proxy project, .e.g. [proxy-docker](https://harbor.uni-muenster.de/harbor/projects/109/repositories) for Docker Hub and the image you want to pull, e.g. [Arch Linux](https://hub.docker.com/_/archlinux) and pull them via the proxy, like this:

```bash
docker pull harbor.uni-muenster.de/proxy-docker/library/archlinux
```

## Login

To login go to https://harbor.uni-muenster.de and click `LOGIN VIA OIDC PROVIDER`.
You will be redirected and you can then login with your university account name and password.

## Docker Configuration

To login with docker you need to use the `Username` and `CLI Secret` from the `User Profile` in the Harbor UI. With that you can login via console as follows:

```bash
$ docker login harbor.uni-muenster.de
Username: max.mustermann@uni-muenster.de
Password:
Login Succeeded
```