Skip to content

Commit 08cbc6c

Browse files
hub: service accounts (#24067)
<!--Delete sections as needed --> ## Description - Removed service accounts topic - Removed migration steps from OATs topic - Redirected to retired that points to OATs - Added a retired notice in retirement topic https://deploy-preview-24067--docsdocker.netlify.app/retired/#enhanced-service-account-add-ons https://deploy-preview-24067--docsdocker.netlify.app/enterprise/security/access-tokens/ https://deploy-preview-24067--docsdocker.netlify.app/docker-hub/service-accounts/ ## Related issues or tickets ENGDOCS-3172 ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Editorial review - [ ] Product review --------- Signed-off-by: Craig Osterhout <craig.osterhout@docker.com> Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
1 parent 4cae670 commit 08cbc6c

3 files changed

Lines changed: 13 additions & 64 deletions

File tree

content/manuals/docker-hub/service-accounts.md

Lines changed: 0 additions & 36 deletions
This file was deleted.

content/manuals/enterprise/security/access-tokens.md

Lines changed: 0 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -104,34 +104,6 @@ organization.
104104
- **Delete**
105105
1. Select **Save** after making changes to a token.
106106

107-
## Migrate from service accounts
108-
109-
[Enhanced Service Account add-ons](/manuals/docker-hub/service-accounts.md)
110-
are deprecated and no longer available for
111-
new purchases as of December 10, 2024.
112-
113-
Organization access tokens provide a
114-
modern, secure replacement with additional benefits:
115-
116-
| Feature | Service accounts | Organization access tokens |
117-
|---------|------------------|----------------------------|
118-
| Authentication | Username/password | Organization name + token |
119-
| Cost | Tiered add-on pricing | Included with subscription |
120-
| Management | Individual account-based | Organization owner managed |
121-
| Repository access | Full account access | Granular repository permissions |
122-
| Security | Basic password auth | Token-based with expiration |
123-
| Rate limits | Separate tiered limits | Organization subscription limits |
124-
125-
### Migration steps
126-
127-
To migrate from service accounts to OATs, use the following steps:
128-
129-
1. Document current service accounts and their purposes.
130-
1. Generate organization access tokens with appropriate repository permissions.
131-
1. Replace service account credentials in your systems.
132-
1. Validate all automated workflows work correctly.
133-
1. Remove deprecated service account credentials.
134-
135107
## Organization access token best practices
136108

137109
- Regular token rotation: Set reasonable expiration dates and rotate tokens regularly to minimize security risks.

content/manuals/retired.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ params:
88
sidebar:
99
group: Products
1010
aliases:
11+
- /docker-hub/service-accounts/
1112
- /cloud/
1213
- /cloud/aci-compose-features/
1314
- /cloud/aci-container-features/
@@ -156,6 +157,18 @@ which led to the retirement of the Docker for GitHub Copilot extension. If
156157
you're looking for AI-assisted Docker workflows, explore the Docker MCP Toolkit
157158
and MCP Catalog, or use Ask Gordon in Docker Desktop and the Docker CLI.
158159

160+
### Enhanced Service Account add-ons
161+
162+
Enhanced Service Account add-ons provided tiered pull rate limits for automated
163+
workflows and service accounts accessing Docker Hub.
164+
165+
Docker recommends transitioning to [Organization Access Tokens
166+
(OATs)](/manuals/enterprise/security/access-tokens.md), which provide secure,
167+
programmatic access to Docker Hub with granular repository permissions, token
168+
expiration, and better security auditing. OATs are included with Docker Team
169+
and Business subscriptions and offer similar functionality without requiring
170+
separate add-on purchases.
171+
159172
## Open source projects
160173

161174
Several open-source projects originally maintained by Docker have been

0 commit comments

Comments
 (0)