Skip to main content

Docker Hub

Where to apply for a Docker Hub personal access token and how to connect it to Nora.
Docker Hub integrations let your agents pull/push images, manage repositories, and inspect automated builds. Nora authenticates with your Docker Hub username plus a personal access token.

Where to apply for credentials

Personal access tokens are issued from Account Settings:

Docker Hub — Personal Access Tokens

Token permissions

When generating the token, choose one of:
Access scopeUse when
Read & WriteAgent pushes images or modifies repositories
Read onlyAgent only pulls / inspects
Public Repo ReadAgent only pulls public images (no private access)
Nora doesn’t enforce a minimum scope — it just calls POST /v2/users/login to verify the credentials.

Connect in Nora

1

Open the Docker Hub integration

From an agent’s detail page, open the Integrations tab and find Docker Hub in the catalog.
2

Paste username and token

Enter your Docker Hub Username (not your email) and paste the Access Token.
3

Connect

Click Connect. Nora encrypts the token and calls POST https://hub.docker.com/v2/users/login to verify the credentials.

Verify the connection

The Test button calls the same /v2/users/login. Common failures:
  • 401 Unauthorized — wrong username, wrong token, or token expired.
  • Docker Hub username not configured — Nora needs the username explicitly because the API expects it in the JSON body.

MCP server

No official Docker Hub MCP server today.

Environment variables Nora injects

VariableSource
DOCKER_HUB_TOKENAccess Token field
DOCKER_HUB_USERNAMEUsername field