---
name: openshift-ts-app-03-docker-pull
title: Why can't I push or pull images from my local machine to the Docker registry?
description: Learn how to resolve issues when you can't push or pull Docker images from your local machine to the cluster's built-in Docker registry.
last-updated: 2026-04-09
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/openshift?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.

# Why can't I push or pull images from my local machine to the Docker registry?
{: #ts-app-docker-local}
{: troubleshoot}
{: support}

[Virtual Private Cloud]{: tag-vpc} [Classic infrastructure]{: tag-classic-inf}

Learn how to resolve issues when you can't push or pull Docker images from your local machine to the cluster's built-in Docker registry.
{: shortdesc}

You can't push or pull Docker images from your local machine to the cluster's built-in Docker registry.
{: tsSymptoms}


By default, the Docker registry is available internally within the cluster. You can build apps from remote directories such as GitHub or Docker Hub by using the `oc new-app` command. Or, you can expose your Docker registry such as with a route or load balancer so that you can push and pull images from your local machine.
{: tsCauses}


Create a route for the image registry service. For more information, see [Setting up a secure external route for the internal registry](https://cloud.ibm.com/docs/openshift?topic=openshift-registry&format=markdown#route_internal_registry).
{: tsResolve}