Skip to content

Commit 17c998c

Browse files
craig-osterhoutcraig-osterhout
authored
hub: usage updates (#22326)
<!--Delete sections as needed --> ## Description https://deploy-preview-22326--docsdocker.netlify.app/docker-hub/usage/ https://deploy-preview-22326--docsdocker.netlify.app/docker-hub/usage/pulls/ https://deploy-preview-22326--docsdocker.netlify.app/subscription/details/ ## Related issues or tickets ENGDOCS-2508 ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Editorial review - [ ] Product review Signed-off-by: Craig <[email protected]>
1 parent d16a610 commit 17c998c

File tree

4 files changed

+24
-42
lines changed

4 files changed

+24
-42
lines changed

‎content/includes/hub-limits.md‎

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

‎content/manuals/docker-hub/usage/_index.md‎

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,19 +8,17 @@ aliases:
88
/docker-hub/download-rate-limit/
99
---
1010

11-
{{% include "hub-limits.md" %}}
12-
1311
The following table provides an overview of the included usage and limits for each
1412
user type, subject to fair use:
1513

1614

17-
| User type | Pull rate limit per hour | Number of public repositories | Number of private repositories |
18-
|--------------------------|----------------------------------------|---------------------|----------------------|
19-
| Business (authenticated) | Unlimited | Unlimited | Unlimited |
20-
| Team (authenticated) | Unlimited | Unlimited | Unlimited |
21-
| Pro (authenticated) | Unlimited | Unlimited | Unlimited |
22-
| Personal (authenticated) | 100 | Unlimited | Up to 1 |
23-
| Unauthenticated users | 10 per IPv4 address or IPv6 /64 subnet | Not applicable | Not applicable |
15+
| User type | Pull rate limit per 6 hours | Number of public repositories | Number of private repositories |
16+
|--------------------------|-----------------------------------------|-------------------------------|--------------------------------|
17+
| Business (authenticated) | Unlimited | Unlimited | Unlimited |
18+
| Team (authenticated) | Unlimited | Unlimited | Unlimited |
19+
| Pro (authenticated) | Unlimited | Unlimited | Unlimited |
20+
| Personal (authenticated) | 200 | Unlimited | Up to 1 |
21+
| Unauthenticated users | 100 per IPv4 address or IPv6 /64 subnet | Not applicable | Not applicable |
2422

2523
For more details, see [Pull usage and limits](./pulls.md).
2624

‎content/manuals/docker-hub/usage/pulls.md‎

Lines changed: 15 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -9,22 +9,20 @@ aliases:
99
- /docker-hub/usage/repositories/
1010
---
1111

12-
{{% include "hub-limits.md" %}}
13-
14-
Unauthenticated and Docker Personal users are subject to hourly pull rate limits
12+
Unauthenticated and Docker Personal users are subject to a 6-hour pull rate limit
1513
on Docker Hub. In contrast, Docker Pro, Team, and Business users benefit from
16-
unlimited pulls per hour.
14+
an unlimited pull rate.
1715

1816
The following pull usage and limits apply based on your subscription, subject to
1917
fair use:
2018

21-
| User type | Pull rate limit per hour |
22-
|--------------------------|----------------------------------------|
23-
| Business (authenticated) | Unlimited |
24-
| Team (authenticated) | Unlimited |
25-
| Pro (authenticated) | Unlimited |
26-
| Personal (authenticated) | 100 |
27-
| Unauthenticated Users | 10 per IPv4 address or IPv6 /64 subnet |
19+
| User type | Pull rate limit per 6 hours |
20+
|--------------------------|-----------------------------------------|
21+
| Business (authenticated) | Unlimited |
22+
| Team (authenticated) | Unlimited |
23+
| Pro (authenticated) | Unlimited |
24+
| Personal (authenticated) | 200 |
25+
| Unauthenticated Users | 100 per IPv4 address or IPv6 /64 subnet |
2826

2927
## Pull definition
3028

@@ -151,9 +149,9 @@ separated file with the following detailed information.
151149
| `version_checks` | The number of version checks accumulated for the date and hour of each image repository. Depending on the client, a pull can do a version check to verify the existence of an image or tag without downloading it. | This helps identify the frequency of version checks, which you can use to analyze usage trends and potential unexpected behaviors. |
152150
| `pulls` | The number of pulls accumulated for the date and hour of each image repository. | This helps identify the frequency of repository pulls, which you can use to analyze usage trends and potential unexpected behaviors. |
153151

154-
## View hourly pull rate and limit
152+
## View pull rate and limit
155153

156-
The pull rate limit is calculated on a per hour basis. There is no pull rate
154+
The pull rate limit is calculated on a 6-hour basis. There is no pull rate
157155
limit for users or automated systems with a paid subscription. Unauthenticated
158156
and Docker Personal users using Docker Hub will experience rate limits on image
159157
pulls.
@@ -200,13 +198,13 @@ To view your current pull rate and limit:
200198
3. Examine the headers. You should see the following headers.
201199

202200
```text
203-
ratelimit-limit: 100;w=3600
204-
ratelimit-remaining: 20;w=3600
201+
ratelimit-limit: 100;w=21600
202+
ratelimit-remaining: 20;w=21600
205203
docker-ratelimit-source: 192.0.2.1
206204
```
207205

208-
In the previous example, the pull limit is 100 pulls per 3600 seconds (1
209-
hour), and there are 20 pulls remaining.
206+
In the previous example, the pull limit is 100 pulls per 21600 seconds (6
207+
hours), and there are 20 pulls remaining.
210208

211209
If you don't see any `ratelimit` header, it could be because the image or your IP
212210
is unlimited in partnership with a publisher, provider, or an open source

‎content/manuals/subscription/details.md‎

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ Docker Personal includes:
4242

4343
- 1 included repository with continuous vulnerability analysis in Docker Scout
4444
- Unlimited public Docker Hub repositories
45-
- 100 pulls per hour Docker Hub image pull rate limit for authenticated users
45+
- 100 pulls per 6 hours Docker Hub image pull rate limit for authenticated users
4646
- 7-day Docker Build Cloud trial
4747
- 7-day Testcontainers Cloud trial
4848

@@ -51,14 +51,12 @@ Testcontainers Cloud after their trial can upgrade to a Docker Pro plan at any
5151
time.
5252

5353
All unauthenticated users, including unauthenticated Docker Personal users, get
54-
10 pulls per hour per IP address.
54+
100 pulls per 6 hours per IPv4 address or IPv6 /64 subnet.
5555

5656
For a list of features available in each tier, see [Docker Pricing](https://www.docker.com/pricing/).
5757

5858
## Docker Pro
5959

60-
{{% include "hub-limits.md" %}}
61-
6260
**Docker Pro** enables individual developers to get more control of their
6361
development environment and provides an integrated and reliable developer
6462
experience. It reduces the amount of time developers spend on mundane and
@@ -80,8 +78,6 @@ Pricing](https://www.docker.com/pricing/).
8078

8179
## Docker Team
8280

83-
{{% include "hub-limits.md" %}}
84-
8581
**Docker Team** offers capabilities for collaboration, productivity, and
8682
security across organizations. It enables groups of developers to unlock the
8783
full power of collaboration and sharing combined with essential security
@@ -106,8 +102,6 @@ Pricing](https://www.docker.com/pricing/).
106102

107103
## Docker Business
108104

109-
{{% include "hub-limits.md" %}}
110-
111105
**Docker Business** offers centralized management and advanced security features
112106
for enterprises that use Docker at scale. It empowers leaders to manage their
113107
Docker development environments and speed up their secure software supply chain

0 commit comments

Comments
 (0)