> For the complete documentation index, see [llms.txt](https://docs.heeler.com/mrecEO40m5D6bt7Pq5pE/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.heeler.com/mrecEO40m5D6bt7Pq5pE/get-started/registries-and-artifacts/docker-hub.md).

# Docker Hub

Connect Docker Hub so Heeler can pull and analyze the container images you run.

Heeler connects to the **Docker Hub** container registry to analyze the images running in your environment. It authenticates with a **Docker Hub Personal Access Token (PAT)**.

## Before you start

* **Administrator** role in Heeler.
* A Docker Hub account with permission to create a **Read-only Personal Access Token (PAT)** for the namespace whose images Heeler will analyze.

## Step 1 — Create a Docker Hub PAT

1. Go to [Docker Hub → Account Settings → Security](https://hub.docker.com/settings/security).
2. Click **Generate new token**, give it a name and expiration.
3. Set the access permission to **Read-only**.
4. Copy the generated token for Heeler.

## Step 2 — Add Docker Hub in Heeler

{% stepper %}
{% step %}

### Open the modal

Go to **Connections → Registries → Add Registry → Docker Hub**.
{% endstep %}

{% step %}

### Configure it

* **Name** — any label for the connection.
* **Username** — the user that generated the PAT.
* **Token** — the PAT (or OAT) from Step 1.
* **Namespace** — the Docker namespace for the repositories (e.g. `acmecorp`).

<figure><img src="https://414480750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXP3dp2kecwKA2KvYkntz%2Fuploads%2Fgit-blob-dcbac40c951b2424b597bf2799cc01c88b956f49%2Fcc-gs-reg-dockerhub-form.png?alt=media" alt="The Add Registry modal for Docker Hub, showing Name, Username, Token, and Namespace fields."><figcaption><p>Docker Hub connects with a read-only access token and your namespace.</p></figcaption></figure>

Click **Save**.
{% endstep %}

{% step %}

### Verify

Under **Connections → Registries**, confirm the Docker Hub connection is **Healthy**.

<figure><img src="https://414480750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXP3dp2kecwKA2KvYkntz%2Fuploads%2Fh0pO86n5SNYGHIvaYUO3%2Fharbor_listing.png?alt=media&amp;token=1e1031d9-242a-42cc-9851-4605cc2ea1f2" alt="The Registries list showing the Docker Hub connection with a Healthy status."><figcaption><p>Find the Docker Hub connection in the registry list and confirm its status is <strong>Healthy</strong>.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## You're done when…

* [ ] The Docker Hub connection shows **Healthy** under **Connections → Registries**.
* [ ] Images from your namespace correlate in the [Catalog](/mrecEO40m5D6bt7Pq5pE/catalog.md).
* [ ] Findings begin populating — see [Quickstart](/mrecEO40m5D6bt7Pq5pE/get-started/quickstart.md).

## Troubleshooting

<table><thead><tr><th width="300">Symptom</th><th>Fix</th></tr></thead><tbody><tr><td>Connection shows <strong>Unhealthy</strong></td><td>The token is wrong, expired, or not <strong>Read-only</strong> on the namespace. Generate a new read-only PAT and re-enter it with the username that created it.</td></tr><tr><td>No images appear in the Catalog</td><td>Check the <strong>Namespace</strong> — it must match the Docker namespace that owns the repositories (e.g. <code>acmecorp</code>).</td></tr></tbody></table>

## Related

* [Connect Registries and Artifacts](/mrecEO40m5D6bt7Pq5pE/get-started/registries-and-artifacts.md) — the common flow.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.heeler.com/mrecEO40m5D6bt7Pq5pE/get-started/registries-and-artifacts/docker-hub.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.