# Troubleshoot Docker Hub


Si experimentas problemas con Docker Hub, consulta las siguientes soluciones.

## Has alcanzado tu límite de tasa de descarga (código de respuesta 429)

### Mensaje de error

Cuando ocurre este problema, recibes el siguiente mensaje de error en la CLI de Docker o en los registros de Docker Engine:

```text
You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limits
```

### Posibles causas

- Has alcanzado tu límite de tasa de descarga como usuario autenticado de Docker Personal.
- Has alcanzado tu límite de tasa de descarga como usuario no autenticado basado en tu dirección IPv4 o subred IPv6 /64.

### Solución

Puedes utilizar una de las siguientes soluciones:

- [Autentícate](/docker-hub/usage/pulls/#authentication) o [actualiza (upgrade)](/subscription/change/#upgrade-your-subscription) tu cuenta de Docker.
- [Visualiza tu límite de tasa de descarga](/docker-hub/usage/pulls/#view-hourly-pull-rate-and-limit), espera hasta que disminuya tu tasa de descargas e inténtalo de nuevo.

## Demasiadas solicitudes (código de respuesta 429)

### Mensaje de error

Cuando ocurre este problema, recibes el siguiente mensaje de error en la CLI de Docker o en los registros de Docker Engine:

```text
Too Many Requests
```

### Posibles causas

- Has alcanzado el [Límite de tasa por abuso](/docker-hub/usage/#abuse-rate-limit).

### Solución

1. Comprueba si hay pipelines de CI/CD rotos que accedan a Docker Hub y corrígelos.
2. Implementa una solución de reintento con retroceso gradual (back-off) en tus scripts automatizados para asegurarte de no reenviar miles de solicitudes por minuto.

## Código de respuesta 500

### Mensaje de error

Cuando ocurre este problema, el siguiente mensaje de error es común en la CLI de Docker o en los registros de Docker Engine:

```text
Unexpected status code 500
```

### Posibles causas

- Existe un problema temporal en el servicio de Docker Hub.

### Solución

1. Visualiza la [página de estado del sistema de Docker](https://www.dockerstatus.com/) y verifica que todos los servicios estén operativos.
2. Intenta acceder a Docker Hub nuevamente. Puede ser un problema temporal.
3. [Ponte en contacto con el soporte de Docker](https://www.docker.com/support/) para informar del problema.