Skip to main content

Overview

Buckle connects AI agents to Docker Hub with your username and a personal access token. Agents can browse and manage repositories, tags, and organizations. The gateway injects the credentials into every request, so your agent never sees them. Connecting takes about a minute.

What you will set up

  • A Docker Hub personal access token, read-only or read and write
  • Automatic credential injection on Docker Hub requests
  • Per-agent, per-tool access, with approval for deletes

Connect Docker Hub

1

Create a personal access token in Docker

Open app.docker.com, then Account settings > Personal access tokens, and click Generate new token. Name it Buckle, choose the access permissions (Read-only, or Read & Write if agents should change repositories), and copy the token right away. Tokens start with dckr_pat_.
2

Enter it in Buckle

In the Buckle dashboard, open Settings > Apps > Docker Hub, enter your Username and the Personal Access Token, and click Connect Docker Hub.
Buckle connect window for Docker Hub, showing the setup guide link, the Username and Personal Access Token fields, and the Connect Docker Hub button.

The Docker Hub connect window in Buckle.

Buckle signs in to Docker Hub when you connect and rejects wrong credentials right away.

What agents can do

Controlling access

Grant the connection to each agent that needs it, and choose per tool what runs freely, what needs approval, and what’s blocked. Delete repository and Delete tag can’t be undone, so put them behind approval. Organization rules add guardrails on top. A blocked request never reaches Docker Hub. To disconnect, remove the connection in Settings > Apps > Docker Hub, then delete the token in Docker under Personal access tokens.

FAQ

Generate a new personal access token in Docker, then update it in Settings > Apps > Docker Hub. Agents pick up the new token automatically. Then delete the old token.
Store it in Buckle instead of running docker login in the agent’s environment. The gateway injects it at the proxy. See How it works.
Yes. Use a Read-only token, or put Delete repository and Delete tag behind approval when you grant the connection.