# Docker Hub: Zugangsdaten

Unter Anbindungen, Kategorie Docker-Registries, hinterlegst du Docker Hub per Access Token. GitHub-Hosting braucht diese Anbindung, damit Builds Images dorthin pushen und GitOps sie von dort zieht.

> Source: https://www.mainpath.ai/de/docs/docker-hub-credentials/

**Docker Hub** liegt unter **Anbindungen** in der Kategorie **Docker-Registries**. Docker bietet für Registry-Login **kein OAuth für Drittanbieter**; MainPath prüft deshalb Benutzername und **Personal Access Token** gegen die Docker-Hub-Login-API.

Wenn du ein Projekt auf **GitHub** hostest, ist eine Docker-Hub-Anbindung Pflicht. GitLab.com und Self-hosted GitLab nutzen die Container Registry derselben GitLab-Instanz, siehe [GitLab: Zugangsdaten]({{< relref "gitlab-credentials" >}}).

## Access Token

1. Lege in Docker Hub unter **Account Settings → Personal access tokens** einen Token mit **Read, Write, Delete** auf die Registry an (mindestens Read & Write).
2. Öffne **Anbindungen → Docker-Registries → Docker Hub**.
3. Trage **Name**, **Slug**, **Benutzername** (Docker-ID) und den Token ein. **Namespace** ist optional: leer bleibt es bei der Docker-ID, sonst eine Organisation, in die du pushen darfst.

MainPath prüft die Zugangsdaten mit einem Login gegen `hub.docker.com`. Der Token liegt in OpenBao, nicht im Klartext in Git.

## Im Projekt nutzen

Beim Projekt unter **Repositories** erscheint die Auswahl **Docker-Registry**, sobald mindestens eine Komponente oder GitOps auf **GitHub** steht.

Images heißen `docker.io/<namespace>/<projekt-slug>-<komponente>`, zum Beispiel `docker.io/acme/student-pro-backend`. GitHub Actions schreibt `.github/workflows/docker-publish.yml` und setzt die Secrets `DOCKERHUB_USERNAME` und `DOCKERHUB_TOKEN`. GitOps zieht dieselben Namen.

Ohne Dockerfile im Repository wird der Publish-Job übersprungen.

## Was nicht geht

- OAuth gegen Docker Hub für den Registry-Login
- Nested Pfade wie bei GitLab (`gruppe/projekt/backend`); Docker Hub kennt nur `namespace/name`

