Docker Hub · Organization access token

How an agent gets a Docker Hub · Organization access token key through KeyKeeper, what to choose on app.docker.com, and how KeyKeeper verifies it.

Template iddockerhub-oat
Fielddocker-token → DOCKER_TOKEN · secret
Alsodocker-username → DOCKER_USERNAME · plain, confirmed by you
Key looks likestarts with dckr_oat_, shown once when created
Created atapp.docker.com
Verified by KeyKeepernot verified
Template checked2026-09-15

What the agent does

keykeeper providers show dockerhub-oat
keykeeper save --provider dockerhub-oat --from-clipboard --create --purpose "what this task does"
keykeeper run -c dockerhub-oat -- <your command>

--provider dockerhub-oat fills in the credential id and the fields. The environment variables are the ones Docker Hub's own tools read, so nothing has to be mapped.

What only you can do

Sign in as an organization owner
Open the organization admin console → Access tokens
Choose repositories, permissions and expiry
Copy the key, then approve the save in KeyKeeper's window.

What to choose

Organization access tokens require an eligible subscription. Grant only exact repositories and Read/Write; avoid Delete unless explicitly needed.

The agent is told the same thing. It opens the page for you and says what to pick; it never logs in, passes 2FA or pays on your behalf.

What KeyKeeper checks

  • Before writing: the value must look like a Docker Hub · Organization access token key (starts with dckr_oat_, shown once when created). A wrong paste is refused before anything is stored, and the agent is told why — without the value.
  • After saving: Docker Hub · Organization access token offers no read-only endpoint KeyKeeper can use, so the first real call is the test.

Rotation and expiry

No universal expiry policy was confirmed for this credential type. Record the date shown by the provider, or leave it unknown. Rotate or revoke at app.docker.com.