2026.4.3
Home ▸ More info

Docker Hub Rate Limit

The issue

Docker Hub enforces a limit on how often you can fetch container information from their container registry. For more details, see the Docker Hub rate limit documentation.

Home Assistant uses Docker Hub as the container registry. When your IP address is rate limited, updating Home Assistant containers will fail.

The solutions

If you are running watchtower or similar solutions to keep your containers up to date, reconfigure them to check less often. If you are running a Supervised installation, you should also consider removing them completely, since running software alongside the Supervisor is not supported.

Once you’ve done that, you need to wait until the limit is lifted. This can take up to 6 hours.

If you are sharing the IP address with other parties, their usage will also affect you. The Supervisor supports signing in to Docker Hub with an account. With an account, all fetches between the Supervisor and Docker Hub are authenticated and are not limited by the anonymous rate limits. Authenticated users are also rate limited, but that is a dedicated limit tied to your account.

If you do not have a Docker Hub account you can create one here.

To use your Docker Hub credentials with the Supervisor:

  1. You need to have the advanced user toggle enabled in your user profile setting.

  2. Go to Settings > Apps > Install app.

  3. In the top-right corner of the screen, select the three dots menu, and select Registries.

  4. In the dialog that opens up, select Add new registry and enter docker.io as the registry, followed by your credentials:

    Adding authentication for Docker Hub in the Supervisor panel. Adding authentication for Docker Hub in the Supervisor panel.

    Note

    The screenshot above may show `hub.docker.com` as the registry value, but the correct value is `docker.io`. `hub.docker.com` is the website for browsing Docker Hub, while `docker.io` is the registry hostname the Supervisor uses to authenticate.

    If you do not want to use the UI, this can also be done with the CLI