Skip to main content

Docker Hub Integration

Sync container images from your Docker Hub accounts for scanning.

Written by Frankie Cade

🎫 Plan availability: The Docker Hub integration is available on all plans.

ℹ️ Note: Only Intruder users with the admin role can add and remove the Docker Hub integration.

Overview

The Docker Hub integration allows you to connect your personal accounts to Intruder so that you can easily scan container images stored in your Docker Hub repositories.

Connect your Docker Hub account:

To connect your Docker Hub account to Intruder:

  1. Create a personal access token in Docker Hub with Read-only access permissions and copy the value.

    ⬇️

    ⬇️

    ⬇️

  2. Navigate to Integrations > Docker Hub > + Add in Intruder.


  3. Enter your username and personal access token, and click Connect.

    ⬇️


  4. Once syncing has completed, your images will be visible on the Container Images page.

What gets synced

For each connected account, we sync:

  • All repositories owned by that personal account

  • All tags for each repository

  • The last push date

Remove an account

To remove a Docker Hub account, navigate to Integrations > Docker Hub > Settings, then click the trash can icon to the right of the account you wish to delete. Please note that removing a Docker Hub account will delete all associated container images and targets.

Troubleshooting

My sync is slow or seems to pause

  • Docker Hub limits how many requests can be made per account or IP address in a given time. If your namespace has many repositories, syncing may be throttled to stay within these limits. This usually resolves on its own.

My images disappeared after removing an account

  • This is expected. Removing an account removes all of its synced images and any tag rules that used those images as targets.

My token expired, and I can't sync

  • Reconnect the account with a new personal access token. Your existing images and tag rules won't be deleted while the token is expired — syncing simply pauses until you reconnect.

FAQ

Can I connect more than one Docker Hub account?

  • Yes, you can connect multiple personal Docker Hub accounts.

Who can add and remove Docker Hub accounts?

  • Only admins can add and remove Docker Hub accounts.

Does the integration sync the actual image content?

  • No, the integration will sync repository, tag, and digest metadata.

Did this answer your question?