--- name: Registry-ts_index title: Troubleshooting Container Registry issues description: Find answers to common troubleshooting questions about Container Registry, covering authentication errors, image pull failures, namespace issues, and more. last-updated: 2026-08-11 --- > ## Documentation Index > The table of contents for this documentation set is at https://cloud.ibm.com/docs/Registry?format=markdown > The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt > Use these files to discover more information as needed. # Troubleshooting Container Registry issues {: #ts_index} {: troubleshoot} {: support} Find answers to common troubleshooting questions about Container Registry, covering authentication errors, image pull failures, namespace issues, and more. {: shortdesc} ## Troubleshooting topics {: #gettinghelp_ts} The following troubleshooting topics are available to help you: ### Troubleshooting CLI login {: #gettinghelp_ts_cli_login} Troubleshoot log-in problems in the command-line interface (CLI). - [Why can't I log in to Container Registry?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-login&format=markdown) - [Why does the Container Registry login keep expiring?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-login-expire&format=markdown) - [Why can't I get started with Container Registry?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-get-started&format=markdown) - [Why do Container Registry (`ibmcloud cr`) commands fail with a message that they're not registered?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-login-error&format=markdown) - [macOS]{: tag-macos} [Why is `docker login` on my Mac failing?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-docker-mac&format=markdown) ### Troubleshooting pull and push errors {: #gettinghelp_ts_pull_push} Troubleshoot pull and push problems. - [Why can't I push or pull a Docker image?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-push-pull-docker&format=markdown) - [Why is pulling images so slow?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-pull-performance&format=markdown) - [Why am I getting `Authorization required` errors?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-auth-req&format=markdown) - [Why am I getting an `Unauthorized` error when I use Code Engine with Container Registry?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-unauthorized-ce&format=markdown) - [Why have I got a problem when I pull an image with `cosign` when I use Podman?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-cosign-podman&format=markdown) - [Why am I getting `Access denied` errors?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-access-denied&format=markdown) - [Why am I getting errors for a resource?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-resource&format=markdown) - [Why am I getting errors about insufficient scope?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-scope&format=markdown) - [Why am I getting errors about my quota?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-quota&format=markdown) - [Why am I getting errors about using a private network?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-private&format=markdown) - [Why am I getting a `Forbidden` error when I try to access Container Registry when I'm using Code Engine?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-forbidden-ce&format=markdown) - [Why do images fail to pull from registry with ImagePullBackOff or authorization errors?](https://cloud.ibm.com/docs/Registry?topic=Registry-ts-app-image-pull&format=markdown) ### Troubleshooting CLI commands {: #gettinghelp_ts_cli_commands} Troubleshoot CLI command problems. - [Why can't I add a namespace?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-add-namespace&format=markdown) - [Why am I forbidden to create a Container Registry instance in my account?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-create-namespace&format=markdown) - [Why aren't I authorized to access a specified resource?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-namespace-auth&format=markdown) - [Why can't I find my image or my namespace?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-image-find&format=markdown) - [Why don't all my namespaces show in the resource list?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-namespace-resource-list&format=markdown) - [Why does it time out when I list images?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-image-timeout&format=markdown) - [Why can't I pull the newest image by using the `latest` tag?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-docker-latest&format=markdown) - [Why do all the tags get deleted when I delete an image?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-image-rm&format=markdown) - [Why doesn't the retention command show all the images?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-image-list-retention&format=markdown) - [Why do I get an error when I'm restoring an image?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-image-restore&format=markdown) - [Why aren't all the tags restored when I restore by digest?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-image-restore-digest&format=markdown) - [Why do I get a manifest unknown error?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-manifest-unknown&format=markdown) - [Why do I get a manifest type error when I tag my image?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-manifest-error-type&format=markdown) - [Why do I get a manifest version error?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-manifest-error-version&format=markdown) - [Why do I get a manifest list invalid error?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-manifest-list-error&format=markdown) - [Why do I get an error about an invalid version of Vulnerability Advisor being specified?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-va-version-error&format=markdown) ### Troubleshooting networking {: #gettinghelp_ts_network} Troubleshoot networking problems. - [Why can't I access Container Registry through a custom firewall?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-firewall&format=markdown) - [Why can't I connect to Container Registry?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-connect&format=markdown) ### Troubleshooting Portieris {: #gettinghelp_ts_portieris} Troubleshoot Portieris problems. - [Why don't my pods restart after my workers are down when I use Container Registry?](https://cloud.ibm.com/docs/Registry?topic=Registry-troubleshoot-pods&format=markdown)