hub: usage refresh

Signed-off-by: Craig <[email protected]>
docker · Jan 16, 2025 · 818dc23 · 818dc23
1 parent 9e45aa8
commit 818dc23
Show file tree

Hide file tree

Showing 11 changed files with 358 additions and 389 deletions.
diff --git a/content/manuals/desktop/setup/sign-in.md b/content/manuals/desktop/setup/sign-in.md
@@ -42,7 +42,7 @@ In large enterprises where admin access is restricted, administrators can [enfor
 
 - You can access your Docker Hub repositories directly from Docker Desktop.
 
-- Authenticated users also get a higher pull rate limit compared to anonymous users. For example, if you are authenticated, you get 200 pulls per 6 hour period, compared to 100 pulls per 6 hour period per IP address for anonymous users. For more information, see [Download rate limit](/manuals/docker-hub/download-rate-limit.md).
+- Authenticated users also get a higher pull rate limit compared to anonymous users. For more information, see [Usage and limits](/manuals/docker-hub/usage/_index.md).
 
 - Improve your organization’s security posture for containerized development by taking advantage of [Hardened Desktop](/manuals/security/for-admins/hardened-desktop/_index.md).
 

diff --git a/content/manuals/docker-hub/_index.md b/content/manuals/docker-hub/_index.md
@@ -24,10 +24,10 @@ grid:
   description: Learn about organization administration.
   icon: store
   link: /admin/
-- title: Usage
+- title: Usage and limits
   description: Explore usage limits and how to better utilize Docker Hub.
   icon: leaderboard
-  link: /docker-hub/download-rate-limit/
+  link: /docker-hub/usage/
 - title: Release notes
   description: Find out about new features, improvements, and bug fixes.
   icon: note_add

diff --git a/content/manuals/docker-hub/download-rate-limit.md b/content/manuals/docker-hub/download-rate-limit.md
diff --git a/content/manuals/docker-hub/image-library/mirror.md b/content/manuals/docker-hub/image-library/mirror.md
@@ -38,7 +38,7 @@ Hub can be mirrored.
 
 > [!NOTE]
 >
-> Mirrors of Docker Hub are still subject to Docker's [fair use policy](/manuals/docker-hub/download-rate-limit.md#fair-use).
+> Mirrors of Docker Hub are still subject to Docker's [fair use policy](/manuals/docker-hub/usage/_index.md#fair-use).
 
 ### Solution
 

diff --git a/content/manuals/docker-hub/release-notes.md b/content/manuals/docker-hub/release-notes.md
@@ -199,7 +199,7 @@ Docker introduces Hub Vulnerability Scanning which enables you to automatically
 
 * Docker has announced a new, per-seat pricing model to accelerate developer workflows for cloud-native development. The previous private repository/concurrent autobuild-based plans have been replaced with new **Pro** and **Team** plans that include unlimited private repositories. For more information, see [Docker subscription](../subscription/_index.md).
 
-* Docker has enabled download rate limits for downloads and pull requests on Docker Hub. This caps the number of objects that users can download within a specified timeframe. For more information, see [Download rate limit](download-rate-limit.md).
+* Docker has enabled download rate limits for downloads and pull requests on Docker Hub. This caps the number of objects that users can download within a specified timeframe. For more information, see [Usage and limits](/manuals/docker-hub/usage/_index.md).
 
 ## 2019-11-04
 

diff --git a/content/manuals/docker-hub/usage/_index.md b/content/manuals/docker-hub/usage/_index.md
@@ -0,0 +1,56 @@
+---
+description: Learn about usage and limits for Docker Hub.
+keywords: Docker Hub, limit, usage
+title: Docker Hub usage and limits
+linkTitle: Usage and limits
+weight: 30
+aliases:
+  /docker-hub/download-rate-limit/
+---
+
+{{< include "hub-limits.md" >}}
+
+When using Docker Hub, unauthenticated and Docker Personal users are subject to
+strict limits. In contrast, Docker Pro, Team, and Business users benefit from a
+consumption-based model with a base amount of included usage. This included
+usage is not a hard limit; users can scale or upgrade their subscriptions to
+receive additional usage or use on-demand usage.
+
+The following table provides an overview of the included usage and limits for each
+user type, subject to fair use:
+
+
+| User type                | Pulls per month | Pull rate limit per hour | Public repositories | Public repository storage | Private repositories | Private repository storage |
+|--------------------------|-----------------|--------------------------|---------------------|---------------------------|----------------------|----------------------------|
+| Business (authenticated) | 1M              | Unlimited                | Unlimited           | Unlimited                 | Unlimited            | Up to 500 GB               |
+| Team (authenticated)     | 100K            | Unlimited                | Unlimited           | Unlimited                 | Unlimited            | Up to 50 GB                |
+| Pro (authenticated)      | 25K             | Unlimited                | Unlimited           | Unlimited                 | Unlimited            | Up to 5 GB                 |
+| Personal (authenticated) | Not applicable  | 40                       | Unlimited           | Unlimited                 | Up to 1              | Up to 2 GB                 |
+| Unauthenticated users    | Not applicable  | 10 per IP address        | Not applicable      | Not applicable            | Not applicable       | Not applicable             |
+
+For more details, see the following:
+
+- [Pull usage and limits](./pulls.md)
+- [Storage usage and limits](./storage.md)
+
+## Fair use
+
+When utilizing the Docker Platform, users should be aware that excessive data
+transfer, pull rates, or data storage can lead to throttling, or additional
+charges. To ensure fair resource usage and maintain service quality, we reserve
+the right to impose restrictions or apply additional charges to accounts
+exhibiting excessive data and storage consumption.
+
+### Abuse rate limit
+
+Docker Hub has an abuse rate limit to protect the application and
+infrastructure. This limit applies to all requests to Hub properties including
+web pages, APIs, and image pulls. The limit is applied per-IP, and while the
+limit changes over time depending on load and other factors, it's in the order
+of thousands of requests per minute. The abuse limit applies to all users
+equally regardless of account level.
+
+You can differentiate between the pull rate limit and abuse rate limit by
+looking at the error code. The abuse limit returns a simple `429 Too Many
+Requests` response. The pull limit returns a longer error message that includes
+a link to documentation.
diff --git a/content/manuals/docker-hub/usage/manage.md b/content/manuals/docker-hub/usage/manage.md
@@ -0,0 +1,49 @@
+---
+description: Learn how to optimize and manage your Docker Hub usage.
+keywords: Docker Hub, limit, usage
+title: Best practices for optimizing Docker Hub usage
+linkTitle: Optimize usage
+weight: 40
+---
+
+Use the following steps to help optimize and manage your Docker Hub usage for
+both individuals and organizations:
+
+1. [View your Docker Hub usage](https://hub.docker.com/usage).
+
+2. Use the Docker Hub usage data to identify which accounts consume the most
+   data, determine peak usage times, and identify which images are related to
+   the most data usage. In addition, look for usage trends, such as the
+   following:
+
+   - Inefficient pull behavior: Identify frequently accessed repositories to
+     assess whether you can optimize caching practices or consolidate usage to
+     reduce pulls.
+   - Inefficient automated systems: Check which automated tools, such as CI/CD
+     pipelines, may be causing higher pull rates, and configure them to avoid
+     unnecessary image pulls.
+
+3. Optimize image pulls by:
+
+   - Use caching: Implement local image caching via
+     [mirroring](/docker-hub/mirror/) or within your CI/CD pipelines to reduce
+     redundant pulls.
+   - Automate manual workflows: Avoid unnecessary pulls by configuring automated
+     systems to pull only when a new version of an image is available.
+
+4. Optimize your storage by:
+
+    - Regularly audit and remove repositories with untagged, unused, or outdated images.
+    - Look for private repositories in Hub storage that exceed your plan's limits.
+
+5. Increase your limits by upgrading or purchasing additional consumption. For
+   details, see [Scale your subscription](/manuals/subscription/scale.md).
+
+6. For organizations, monitor and enforce organizational policies by doing the
+   following:
+
+   - Routinely [view Docker Hub usage](https://hub.docker.com/usage) to monitor usage.
+   - [Enforce sign-in](/security/for-admins/enforce-sign-in/) to ensure that you
+     can monitor the usage of your users and users receive higher usage limits.
+   - Look for duplicate user accounts in Docker and remove accounts from your organization
+   as needed.