Before you start

Authentication tokens, image manifests and layers are separate stages; HTTP 429 often indicates a rate limit.

Step by step

  1. Confirm the official entry point through https://docs.docker.com/docker-hub/. Avoid unfamiliar sign-in pages.
  2. Use one device and one network exit to open Docker Hub; identify whether the home page, sign-in redirect or actual feature fails.
  3. Authentication tokens, image manifests and layers are separate stages; HTTP 429 often indicates a rate limit.
  4. Pull one small public image and record whether authentication, the manifest or a layer download fails.
  5. For 401 or 403, check account status and the displayed message before changing network settings.
  6. Change one condition at a time; if an official incident is active, follow the provider’s updates.

Official references

Use these provider resources for current rules. Some announcement links are help pages, not live availability tests.

Common questions

Can switching networks fix every Docker Hub error?

No. Account privileges, subscriptions, file permissions and service outages require separate checks.

What should I send to support?

Share the time, client version, redacted error code and minimal reproduction. Never share a password, token, cookie or one-time code.