---
title: "Pull an image"
description: "Pull an image from a TIR Container Registry to any machine where you are logged in."
content_type: "how-to"
product: "tir-container-registry"
platform: "TIR"
url: "/tir/tir-container-registry/how-to/pull-an-image/"
topic: ["push-and-pull"]
relationships: {"requires":["/tir/tir-container-registry/how-to/log-in-to-a-registry/"]}
---

# Pull an image

Pull an image from your registry to any machine where you are logged in.

## Before you begin

Make sure that you have
[logged in to the registry](/tir/tir-container-registry/how-to/log-in-to-a-registry/) on that machine.
A private image needs that login before you can pull it.

## Pull it

```bash
docker pull <endpoint>/<namespace>/<image>:<tag>
```

## Pull the exact content

The **Pull Command** column on the registry's **Images** tab copies a command that ends in `@<digest>`
instead of `:<tag>`:

```bash
docker pull <endpoint>/<namespace>/<image>@<digest>
```

That command always pulls the content you saw in the table, even if the tag later points somewhere
else. To find the command, see
[See the images in a registry](/tir/tir-container-registry/how-to/see-the-images-in-a-registry/).