| copyright |
|
||
|---|---|---|---|
| lastupdated | 2025-08-12 | ||
| keywords | error, registry, push, Docker image, pull, Docker image, quota, pricing plan, pull traffic, storage quota | ||
| subcollection | Registry | ||
| content-type | troubleshoot |
{{site.data.keyword.attribute-definition-list}}
{: #troubleshoot-push-pull-docker} {: troubleshoot} {: support}
When you're using {{site.data.keyword.registrylong}}, pushing or pulling a Docker image fails. You might receive various messages, for example, about being over quota or invalid credentials. {: shortdesc}
When you run commands to push or pull Docker images, you receive an error message. The error message varies depending on the root cause. The following error messages are potential error messages that you might receive: {: tsSymptoms}
- Scenario A.
unauthorized: authentication required - Scenario B.
denied: You are not authorized to access the specified resource. - Scenario C.
unauthorized: An error occurred when authenticating your request with IBM Cloud. Clear your browser cookies, log in to IBM Cloud, and try your request again. - Scenario D.
Your account has exceeded its pull traffic quota for the current month., see Why am I getting errors about my quota? for assistance. - Scenario E.
Your account has exceeded its image storage quota for the current month., see Why am I getting errors about my quota? for assistance.
The following alternatives are possible causes: {: tsCauses}
For scenarios A, B, and C the following alternatives are possible causes:
- Docker is not installed.
- The Docker client is not logged in to {{site.data.keyword.registrylong_notm}}.
- Your {{site.data.keyword.cloud_notm}} access token{: term} expired.
You can fix this problem in the following ways: {: tsResolve}
For scenarios A, B, and C complete the following tasks:
- Ensure that Docker is installed on your computer.
- Check your Docker installation path.
- Log in to {{site.data.keyword.cloud_notm}} by running
ibmcloud login. Then, log in to the {{site.data.keyword.registrylong_notm}} command-line interface (CLI) by runningibmcloud cr login.