Why can't I push or pull a Docker image when I use Container Registry?
When you're using IBM Cloud® Container Registry, pushing or pulling a Docker image fails. You might receive various messages, for example, about being over quota or invalid credentials.
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:
- 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:
For scenarios A, B, and C the following alternatives are possible causes:
- Docker is not installed.
- The Docker client is not logged in to IBM Cloud Container Registry.
- Your IBM Cloud access tokenA value used by the consumer to gain access to the protected resources on behalf of the user, instead of using the user's service provider credentials. expired.
You can fix this problem in the following ways:
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 IBM Cloud by running
ibmcloud login
. Then, log in to the IBM Cloud Container Registry CLI by runningibmcloud cr login
.