---
name: Registry-ts_pull_performance
title: Troubleshooting slow image pulls in Container Registry
description: Pulling an image from Container Registry is slow or times out. Use these steps to diagnose and resolve image pull performance issues.
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 slow image pulls in Container Registry
{: #troubleshoot-pull-performance}
{: troubleshoot}
{: support}

Pulling an image from Container Registry is slow or times out. Use these steps to diagnose and resolve image pull performance issues.
{: shortdesc}

When you try to pull an image, it takes a long time.
{: tsSymptoms}

The following alternatives are possible causes:
{: tsCauses}

- **Scenario A.** You are using a large image.
- **Scenario B.** You are pulling your image over a long distance.
- **Scenario C.** You have a poor connection.

You can fix this problem in the following ways:
{: tsResolve}

- **Scenario A.** Reduce the size of your image.
- **Scenario B.** Store and pull your images in the same location.
- **Scenario C.** If you are using IBM Cloud Kubernetes Service or Red Hat® OpenShift® Container Platform, you can pull images over the private network to get a faster speed.