ts_index.md

copyright	years 2017, 2026
lastupdated	2026-02-19
keywords	troubleshooting, support, help, error messages, problem, registry, support ticket, ticket
subcollection	Registry
content-type	troubleshoot

{{site.data.keyword.attribute-definition-list}}

Troubleshooting {{site.data.keyword.registryshort_notm}}

{: #ts_index} {: troubleshoot} {: support}

Answers to common troubleshooting questions about how to use {{site.data.keyword.registrylong}}. {: 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 {{site.data.keyword.registryshort}}?
• Why does the {{site.data.keyword.registryshort}} login keep expiring?
• Why can't I get started with {{site.data.keyword.registryshort}}?
• Why do {{site.data.keyword.registryshort_notm}} (ibmcloud cr) commands fail with a message that they're not registered?
• [macOS]{: tag-macos} Why is docker login on my Mac failing?

Troubleshooting pull and push errors

{: #gettinghelp_ts_pull_push}

Troubleshoot pull and push problems.

• Why can't I push or pull a Docker image?
• Why is pulling images so slow?
• Why am I getting Authorization required errors?
  • Why am I getting an Unauthorized error when I use {{site.data.keyword.codeengineshort}} with {{site.data.keyword.registryshort}}?
  • Why have I got a problem when I pull an image with cosign when I use Podman?
• Why am I getting Access denied errors?
  • Why am I getting errors for a resource?
  • Why am I getting errors about insufficient scope?
  • Why am I getting errors about my quota?
  • Why am I getting errors about using a private network?
  • Why am I getting a Forbidden error when I try to access {{site.data.keyword.registryshort}} when I'm using {{site.data.keyword.codeengineshort}}?
  • Why do images fail to pull from registry with ImagePullBackOff or authorization errors?

Troubleshooting CLI commands

{: #gettinghelp_ts_cli_commands}

Troubleshoot CLI command problems.

• Why can't I add a namespace?
• Why am I forbidden to create a {{site.data.keyword.registryshort_notm}} instance in my account?
• Why aren't I authorized to access a specified resource?
• Why can't I find my image or my namespace?
• Why don't all my namespaces show in the resource list?
• Why does it time out when I list images?
• Why can't I pull the newest image by using the latest tag?
• Why do all the tags get deleted when I delete an image?
• Why doesn't the retention command show all the images?
• Why do I get an error when I'm restoring an image?
• Why aren't all the tags restored when I restore by digest?
• Why do I get a manifest unknown error?
• Why do I get a manifest type error when I tag my image?
• Why do I get a manifest version error?
• Why do I get a manifest list invalid error?
• Why do I get an error about an invalid version of Vulnerability Advisor being specified?

Troubleshooting networking

{: #gettinghelp_ts_network}

Troubleshoot networking problems.

• Why can't I access {{site.data.keyword.registryshort}} through a custom firewall?
• Why can't I connect to {{site.data.keyword.registryshort_notm}}?

Troubleshooting Portieris

{: #gettinghelp_ts_portieris}

Troubleshoot Portieris problems.

• Why don't my pods restart after my workers are down when I use {{site.data.keyword.registryshort}}?