# Docker Hub

---
title: Connecting Docker Hub (Personal) to WatchDog Security
category: Integrations
integration_type: api_token
products_supported:
  - Posture Management
  - Inventory
  - Compliance Center
---
This guide explains how to connect **Docker Hub (Personal)** to WatchDog Security using an API access token.

Once connected, WatchDog will monitor your Docker Hub environment for container repository configuration risks and inventory information.

---

## What WatchDog Monitors

:::tip[]
WatchDog operates in **read-only mode** and does **not modify configuration settings** within your Docker Hub environment.
:::

After the integration is connected, WatchDog may monitor:

<Accordion title="Scopes" defaultOpen>

**Docker Repositories**

- Container repositories
- Repository visibility settings
- Repository metadata
- Repository security configuration

</Accordion>

The exact information collected depends on the permissions granted to the API token.

---

## Requirements

Before connecting the integration, ensure the following:

- You have **administrator access** to the Docker Hub account
- You're an **Account Owner** or **Security Admin** in WatchDog UI

---

## Step 1 — Generate a Docker Hub Access Token

Docker Hub uses **Personal Access Tokens (PATs)** to authenticate API access.
1. Log into **Docker Hub**
2. Click your **Profile Icon**
3. Select **Account Settings**
4. Navigate to **Security**
5. Under **Access Tokens**, click **Generate New Token**
6. Provide a **Token Description** (example: *WatchDog Security*)
7. Ensure the token has **Read access**
8. Click **Generate**
9. Copy the generated **Access Token**

:::note[]
Docker Hub access tokens are only displayed **once after creation**. Store the token securely before continuing.
:::

For more details, see Docker's official documentation:
https://docs.docker.com/security/access-tokens/

---

## Step 2 — Connect the Integration in WatchDog

1. Log into the [WatchDog Security Portal](https://app.watchdogsecurity.io)
2. Navigate to **Management → Integrations**
3. Locate **Docker Hub (Personal)**
4. Click **Connect**
5. Enter the generated **Docker Hub Access Token**
6. Click **Connect Integration**

---

## Initial Sync

<Accordion title="After the integration is connected" defaultOpen>

- WatchDog will begin collecting repository metadata from Docker Hub
- The first synchronization typically completes within **5–10 minutes**

</Accordion>

<Accordion title="Data will appear within the following modules" defaultOpen>

- **Posture Management**
- **Inventory**
- **Compliance Center**

</Accordion>

---

## Troubleshooting

<AccordionGroup>

<Accordion title="Integration Fails to Connect" defaultOpen>

Verify the following:

- The access token was copied correctly
- The token has **read permissions**
- The token has not expired or been revoked

</Accordion>

<Accordion title="No Data Appears">

If data does not appear after connecting:

- Wait for the initial synchronization to complete
- Verify the token permissions
- Reconnect the integration if necessary

</Accordion>

</AccordionGroup>

---

## Related Documentation
- [Docker Hub Access Tokens](https://docs.docker.com/security/access-tokens/)