mirror of https://github.com/docker/docs.git
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 <craig.osterhout@docker.com>
This commit is contained in:
Craig Osterhout
GitHub
parent
d16a610c42
commit
17c998c2da
|
|
@ -1,8 +0,0 @@
|
|||
> [!NOTE]
|
||||
>
|
||||
> Starting April 1, 2025, all users with a Pro, Team, or Business
|
||||
> subscription will have unlimited Docker Hub pulls with fair use.
|
||||
> Unauthenticated users and users with a free Personal account have the
|
||||
> following pull limits:
|
||||
> - Unauthenticated users: 10 pulls/hour
|
||||
> - Authenticated users with a free account: 100 pulls/hour
|
||||
|
|
@ -8,19 +8,17 @@ aliases:
|
|||
/docker-hub/download-rate-limit/
|
||||
---
|
||||
|
||||
{{% include "hub-limits.md" %}}
|
||||
|
||||
The following table provides an overview of the included usage and limits for each
|
||||
user type, subject to fair use:
|
||||
|
||||
|
||||
| User type | Pull rate limit per hour | Number of public repositories | Number of private repositories |
|
||||
|--------------------------|----------------------------------------|---------------------|----------------------|
|
||||
| Business (authenticated) | Unlimited | Unlimited | Unlimited |
|
||||
| Team (authenticated) | Unlimited | Unlimited | Unlimited |
|
||||
| Pro (authenticated) | Unlimited | Unlimited | Unlimited |
|
||||
| Personal (authenticated) | 100 | Unlimited | Up to 1 |
|
||||
| Unauthenticated users | 10 per IPv4 address or IPv6 /64 subnet | Not applicable | Not applicable |
|
||||
| User type | Pull rate limit per 6 hours | Number of public repositories | Number of private repositories |
|
||||
|--------------------------|-----------------------------------------|-------------------------------|--------------------------------|
|
||||
| Business (authenticated) | Unlimited | Unlimited | Unlimited |
|
||||
| Team (authenticated) | Unlimited | Unlimited | Unlimited |
|
||||
| Pro (authenticated) | Unlimited | Unlimited | Unlimited |
|
||||
| Personal (authenticated) | 200 | Unlimited | Up to 1 |
|
||||
| Unauthenticated users | 100 per IPv4 address or IPv6 /64 subnet | Not applicable | Not applicable |
|
||||
|
||||
For more details, see [Pull usage and limits](./pulls.md).
|
||||
|
||||
|
|
|
|||
|
|
@ -9,22 +9,20 @@ aliases:
|
|||
- /docker-hub/usage/repositories/
|
||||
---
|
||||
|
||||
{{% include "hub-limits.md" %}}
|
||||
|
||||
Unauthenticated and Docker Personal users are subject to hourly pull rate limits
|
||||
Unauthenticated and Docker Personal users are subject to a 6-hour pull rate limit
|
||||
on Docker Hub. In contrast, Docker Pro, Team, and Business users benefit from
|
||||
unlimited pulls per hour.
|
||||
an unlimited pull rate.
|
||||
|
||||
The following pull usage and limits apply based on your subscription, subject to
|
||||
fair use:
|
||||
|
||||
| User type | Pull rate limit per hour |
|
||||
|--------------------------|----------------------------------------|
|
||||
| Business (authenticated) | Unlimited |
|
||||
| Team (authenticated) | Unlimited |
|
||||
| Pro (authenticated) | Unlimited |
|
||||
| Personal (authenticated) | 100 |
|
||||
| Unauthenticated Users | 10 per IPv4 address or IPv6 /64 subnet |
|
||||
| User type | Pull rate limit per 6 hours |
|
||||
|--------------------------|-----------------------------------------|
|
||||
| Business (authenticated) | Unlimited |
|
||||
| Team (authenticated) | Unlimited |
|
||||
| Pro (authenticated) | Unlimited |
|
||||
| Personal (authenticated) | 200 |
|
||||
| Unauthenticated Users | 100 per IPv4 address or IPv6 /64 subnet |
|
||||
|
||||
## Pull definition
|
||||
|
||||
|
|
@ -151,9 +149,9 @@ separated file with the following detailed information.
|
|||
| `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. |
|
||||
| `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. |
|
||||
|
||||
## View hourly pull rate and limit
|
||||
## View pull rate and limit
|
||||
|
||||
The pull rate limit is calculated on a per hour basis. There is no pull rate
|
||||
The pull rate limit is calculated on a 6-hour basis. There is no pull rate
|
||||
limit for users or automated systems with a paid subscription. Unauthenticated
|
||||
and Docker Personal users using Docker Hub will experience rate limits on image
|
||||
pulls.
|
||||
|
|
@ -200,13 +198,13 @@ To view your current pull rate and limit:
|
|||
3. Examine the headers. You should see the following headers.
|
||||
|
||||
```text
|
||||
ratelimit-limit: 100;w=3600
|
||||
ratelimit-remaining: 20;w=3600
|
||||
ratelimit-limit: 100;w=21600
|
||||
ratelimit-remaining: 20;w=21600
|
||||
docker-ratelimit-source: 192.0.2.1
|
||||
```
|
||||
|
||||
In the previous example, the pull limit is 100 pulls per 3600 seconds (1
|
||||
hour), and there are 20 pulls remaining.
|
||||
In the previous example, the pull limit is 100 pulls per 21600 seconds (6
|
||||
hours), and there are 20 pulls remaining.
|
||||
|
||||
If you don't see any `ratelimit` header, it could be because the image or your IP
|
||||
is unlimited in partnership with a publisher, provider, or an open source
|
||||
|
|
|
|||
|
|
@ -42,7 +42,7 @@ Docker Personal includes:
|
|||
|
||||
- 1 included repository with continuous vulnerability analysis in Docker Scout
|
||||
- Unlimited public Docker Hub repositories
|
||||
- 100 pulls per hour Docker Hub image pull rate limit for authenticated users
|
||||
- 100 pulls per 6 hours Docker Hub image pull rate limit for authenticated users
|
||||
- 7-day Docker Build Cloud trial
|
||||
- 7-day Testcontainers Cloud trial
|
||||
|
||||
|
|
@ -51,14 +51,12 @@ Testcontainers Cloud after their trial can upgrade to a Docker Pro plan at any
|
|||
time.
|
||||
|
||||
All unauthenticated users, including unauthenticated Docker Personal users, get
|
||||
10 pulls per hour per IP address.
|
||||
100 pulls per 6 hours per IPv4 address or IPv6 /64 subnet.
|
||||
|
||||
For a list of features available in each tier, see [Docker Pricing](https://www.docker.com/pricing/).
|
||||
|
||||
## Docker Pro
|
||||
|
||||
{{% include "hub-limits.md" %}}
|
||||
|
||||
**Docker Pro** enables individual developers to get more control of their
|
||||
development environment and provides an integrated and reliable developer
|
||||
experience. It reduces the amount of time developers spend on mundane and
|
||||
|
|
@ -80,8 +78,6 @@ Pricing](https://www.docker.com/pricing/).
|
|||
|
||||
## Docker Team
|
||||
|
||||
{{% include "hub-limits.md" %}}
|
||||
|
||||
**Docker Team** offers capabilities for collaboration, productivity, and
|
||||
security across organizations. It enables groups of developers to unlock the
|
||||
full power of collaboration and sharing combined with essential security
|
||||
|
|
@ -106,8 +102,6 @@ Pricing](https://www.docker.com/pricing/).
|
|||
|
||||
## Docker Business
|
||||
|
||||
{{% include "hub-limits.md" %}}
|
||||
|
||||
**Docker Business** offers centralized management and advanced security features
|
||||
for enterprises that use Docker at scale. It empowers leaders to manage their
|
||||
Docker development environments and speed up their secure software supply chain
|
||||
|
|
|
|||
Loading…
Reference in New Issue