From 17c998c2da9a3ac95e2d9e1c8e321eb3c2385094 Mon Sep 17 00:00:00 2001 From: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com> Date: Thu, 27 Mar 2025 12:35:18 -0700 Subject: [PATCH] hub: usage updates (#22326) ## 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 - [ ] Editorial review - [ ] Product review Signed-off-by: Craig --- content/includes/hub-limits.md | 8 ------ content/manuals/docker-hub/usage/_index.md | 16 +++++------ content/manuals/docker-hub/usage/pulls.md | 32 ++++++++++------------ content/manuals/subscription/details.md | 10 ++----- 4 files changed, 24 insertions(+), 42 deletions(-) delete mode 100644 content/includes/hub-limits.md diff --git a/content/includes/hub-limits.md b/content/includes/hub-limits.md deleted file mode 100644 index 580271c865..0000000000 --- a/content/includes/hub-limits.md +++ /dev/null @@ -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 \ No newline at end of file diff --git a/content/manuals/docker-hub/usage/_index.md b/content/manuals/docker-hub/usage/_index.md index 3d162f1274..44f201ea5f 100644 --- a/content/manuals/docker-hub/usage/_index.md +++ b/content/manuals/docker-hub/usage/_index.md @@ -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). diff --git a/content/manuals/docker-hub/usage/pulls.md b/content/manuals/docker-hub/usage/pulls.md index da281b30a5..2835edad9e 100644 --- a/content/manuals/docker-hub/usage/pulls.md +++ b/content/manuals/docker-hub/usage/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 diff --git a/content/manuals/subscription/details.md b/content/manuals/subscription/details.md index 8a333c66af..db7d160093 100644 --- a/content/manuals/subscription/details.md +++ b/content/manuals/subscription/details.md @@ -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