Staff Pick

๐Ÿ“ก Monitor your APIs โ€” know when they go down before your users do

Better Stack checks uptime every 30 seconds with instant Slack, email & SMS alerts. Free tier available.

Start Free โ†’

Affiliate link โ€” we may earn a commission at no extra cost to you

Docker Status: How to Check If Docker Hub Is Down Right Now (2026)

Updated June 2026 ยท 7 min read ยท By API Status Check

Docker Hub is the world's largest container registry, hosting over 15 million repositories and serving billions of image pulls per month. When Docker Hub goes down โ€” even briefly โ€” it can break CI/CD pipelines, block deployments, and prevent developers from pulling base images. Knowing how to quickly check Docker status is essential for anyone running containerized workloads.

Understanding Docker's Status Page (status.docker.com)

Docker operates status.docker.com โ€” its official status page. Each component maps to a different Docker product or service, so you can pinpoint exactly what's broken.

Docker Hub Registry

Image pulls, pushes, and repository access. The most critical component โ€” affects all docker pull and docker push operations.

Docker Hub Web UI

hub.docker.com website, search, and repository browsing. Web UI can be down while the registry API still works.

Docker Hub API

REST API used by CI/CD tools, Docker CLI, and integrations to authenticate and manage repositories.

Docker Desktop Updates

Desktop app update delivery. Affects Docker Desktop version upgrades, not the core registry.

Docker Scout

Container image vulnerability scanning and software supply chain analysis service.

Docker Build Cloud

Remote build service for faster multi-platform image builds. Separate infrastructure from the registry.

What Docker Status Colors Mean

๐ŸŸข
Operational: All systems working normally. Image pulls and pushes should work without issues.
๐ŸŸก
Degraded Performance: Registry is up but slower than normal. You may see slow docker pull speeds, delayed API responses, or occasional timeout errors.
๐ŸŸ 
Partial Outage: Some users or regions are failing. docker pull may work for some images but fail for others. Rate limit errors may appear incorrectly.
๐Ÿ”ด
Major Outage: Widespread failure. Most docker pull operations will fail. CI/CD pipelines depending on Docker Hub images will break.
๐Ÿ”ต
Maintenance: Planned maintenance window. Docker announces these in advance on status.docker.com. Expect degraded performance or brief unavailability.
๐Ÿ“ก
Recommended

Monitor Docker Hub status automatically

Better Stack lets you create monitors for Docker Hub and your entire container stack. Get Slack, PagerDuty, or SMS alerts the moment Docker Hub goes down โ€” before your CI/CD pipelines fail. Free plan available.

Try Better Stack Free โ†’

5 Ways to Check If Docker Hub Is Down

1.

status.docker.com (Official)

Docker's own status page. Updated by Docker's engineering team during incidents. Reliable but can lag 10โ€“20 minutes behind real outages.

Check status.docker.com โ†’
2.

API Status Check (Independent)

Third-party monitoring that continuously pings Docker Hub endpoints and reports independently. Shows issues even when Docker hasn't updated their status page yet.

Check independent Docker status โ†’
3.

X / Twitter

Search 'Docker Hub down' on X. The developer community often reports Docker issues faster than official channels. Docker's own account posts incident updates.

Search X for 'docker hub down' โ†’
4.

Test a docker pull directly

The fastest check: try pulling a known small image and look at the error. The error message tells you whether it's a rate limit, auth issue, or actual outage.

docker pull hello-world && echo "Docker Hub reachable" || echo "Docker Hub unreachable"
5.

Docker Hub API health check

Query the Docker Hub API directly to check if authentication and registry endpoints are responding.

curl -s https://hub.docker.com/v2/ | head -c 100

Common Docker Error Messages and What They Mean

These are the error messages you'll see when Docker Hub is having issues:

"toomanyrequests: You have reached your pull rate limit"Rate limit exceeded โ€” not an outage. Unauthenticated: 100 pulls/6h per IP. Free account: 200 pulls/6h. Fix: docker login or upgrade to Docker Pro/Team.
"Error response from daemon: Get "https://registry-1.docker.io/v2/": net/http: TLS handshake timeout"Docker Hub registry servers are not responding. Likely a real outage. Check status.docker.com.
"unauthorized: incorrect username or password"Authentication failure. Not an outage โ€” check your docker login credentials or access token expiry.
"Error: failed to do request: Head "https://registry-1.docker.io/v2/library/...": dial tcp: lookup registry-1.docker.io: no such host"DNS resolution failure. Could be local DNS issue or Docker Hub infrastructure problem.
"manifest unknown: manifest unknown"Image or tag not found in registry. Usually a tag naming issue, not an outage. Verify the exact image:tag.
"server misbehaving"Docker Hub registry returned an unexpected response. Usually indicates a partial outage or infrastructure issue on Docker Hub's side.
"pull access denied for <image>, repository does not exist or may require 'docker login'"Private image requires authentication, or the image doesn't exist. Not an outage โ€” authenticate with docker login first.

Docker Hub Outage History: What the Data Shows

Docker Hub has experienced several notable incidents over the years, particularly as container adoption has grown:

2-4x/month
Reported incidents
Including degraded pull speeds and partial registry outages
1-3 hours
Typical incident duration
Most incidents resolve within a few hours
99.5%+
Registry uptime target
Core pull/push operations uptime SLA

Docker Hub rate limiting (introduced in 2020) is the most common "outage-like" experience โ€” but it's not a real outage. True outages typically affect image pulls for all users regardless of auth status. Check our Docker monitoring for current status and recent incident history.

๐Ÿ“ก
Recommended

Get alerted when Docker Hub goes down

Better Stack monitors Docker Hub and your entire container stack. When pulls start failing, you hear about it first โ€” not from a broken CI/CD run. Set up in 2 minutes.

Try Better Stack Free โ†’

What to Do When Docker Hub Is Down

If docker pull Is Failing

  • Distinguish rate limit from outage: check error message
  • Verify at status.docker.com and apistatuscheck.com/is-docker-hub-down
  • Use locally cached images: docker images to see what's cached
  • Mirror critical images to a private registry (ECR, GCR, GHCR)
  • Pull from alternative registries: ghcr.io, quay.io, gcr.io

If CI/CD Pipelines Are Broken

  • Cache base images in your CI provider (GitHub Actions, GitLab CI cache)
  • Use GitHub Container Registry (ghcr.io) as a fallback
  • Set up an ECR or GCR mirror for critical base images
  • Delay non-critical pipelines until Docker Hub recovers
  • Configure retry logic in Docker pull steps

Avoiding Docker Hub Rate Limits

Most "Docker Hub down" experiences in CI/CD are actually rate limit hits. Here's how to avoid them:

โœ“
Authenticate in CI/CD: Always run docker login in your CI pipeline with a Docker Hub service account. Authenticated free accounts get 200 pulls/6h vs 100 for anonymous.
โœ“
Use Docker Pro or Team: Paid Docker accounts get unlimited pulls. For teams with heavy CI/CD usage, this is often cheaper than the engineering time spent debugging rate limits.
โœ“
Mirror images to private registries: Push your critical base images to ECR, GCR, or GHCR. Pull from your private mirror instead of Docker Hub. Eliminates rate limit dependency entirely.
โœ“
Use --pull=never in CI when possible: When you know the image is already cached locally in your CI runner, skip the pull. Use docker build --pull=never to use the cached version.
โœ“
Configure registry mirrors: Docker daemon supports registry mirrors. Point your registry-mirrors config to a pull-through cache to reduce direct Docker Hub requests.

Frequently Asked Questions

Where is the official Docker status page?

Docker's official status page is status.docker.com. It covers Docker Hub (registry, web UI, API), Docker Desktop update delivery, Docker Scout, and Docker Build Cloud. You can subscribe to email notifications directly on the page.

Why is docker pull failing but Docker Hub looks operational?

Docker Hub's status page can lag 10โ€“20 minutes behind real incidents. For faster independent monitoring, check apistatuscheck.com/is-docker-hub-down. Also distinguish between rate limits (toomanyrequests error) and real outages โ€” rate limits are the most common 'Docker down' experience in CI/CD environments.

Is Docker Hub down different from Docker Desktop not working?

Yes. Docker Hub is the cloud container registry at hub.docker.com. Docker Desktop is your local application. Docker Hub can be down while Docker Desktop works perfectly for local builds using cached images. Check status.docker.com and look at which specific component is affected.

What are alternatives to Docker Hub when it is down?

GitHub Container Registry (ghcr.io) is the most popular alternative for open source images. AWS ECR Public Gallery, Google Artifact Registry, and Quay.io are also good options. For production workloads, mirroring critical images to a private ECR or GCR registry is the most reliable approach.

How do I get alerts when Docker Hub goes down?

Subscribe to email updates at status.docker.com, or use Better Stack / API Status Check Alert Pro to set up automated monitoring with custom alert thresholds. For teams, setting up monitoring on your own docker pull test is more reliable than waiting for Docker's official status page to update.

Alert Pro

14-day free trial

Stop checking โ€” get alerted instantly

Next time Docker Hub goes down, you'll know in under 60 seconds โ€” not when your users start complaining.

  • Email alerts for Docker Hub + 9 more APIs
  • $0 due today for trial
  • Cancel anytime โ€” $9/mo after trial

Never Miss a Docker Hub Outage Again

Monitor Docker Hub with independent real-time monitoring. Get alerted before failed CI/CD pipelines and broken deployments affect your team.

Try Better Stack Free โ€” No Credit Card Required

Or use APIStatusCheck Alert Pro โ€” API monitoring from $9/mo

๐ŸŒ Can't Access Docker Hub?

If Docker Hub is working for others but not for you, it might be an ISP or regional issue. A VPN can help bypass network-level blocks and routing problems.

๐Ÿ”’

Troubleshoot with a VPN

Connect from a different region to test if the issue is local to your network. Also protects your connection on public Wi-Fi.

Try NordVPN โ€” 30-Day Money-Back Guarantee
๐Ÿ”‘

Secure Your Docker Hub Account

Service outages are a common time for phishing attacks. Use a password manager to keep unique, strong passwords for every account.

Try NordPass โ€” Free Password Manager
Quick ISP test: Try accessing Docker Hub on mobile data (Wi-Fi off). If it works, the issue is with your ISP or local network.

โณ While You Wait โ€” Try These Alternatives

๐Ÿ›  Tools We Use & Recommend

Tested across our own infrastructure monitoring 200+ APIs daily

Better StackBest for API Teams

Uptime Monitoring & Incident Management

Used by 100,000+ websites

Monitors your APIs every 30 seconds. Instant alerts via Slack, email, SMS, and phone calls when something goes down.

โ€œWe use Better Stack to monitor every API on this site. It caught 23 outages last month before users reported them.โ€

Free tier ยท Paid from $24/moStart Free Monitoring
1PasswordBest for Credential Security

Secrets Management & Developer Security

Trusted by 150,000+ businesses

Manage API keys, database passwords, and service tokens with CLI integration and automatic rotation.

โ€œAfter covering dozens of outages caused by leaked credentials, we recommend every team use a secrets manager.โ€

SEMrushBest for SEO

SEO & Site Performance Monitoring

Used by 10M+ marketers

Track your site health, uptime, search rankings, and competitor movements from one dashboard.

โ€œWe use SEMrush to track how our API status pages rank and catch site health issues early.โ€

From $129.95/moTry SEMrush Free
View full comparison & more tools โ†’Affiliate links โ€” we earn a commission at no extra cost to you