docs: pulling an image (#2956)

* docs: pulling an image

Signed-off-by: Fabrice Flore-Thébault <ffloreth@redhat.com>

* docs: implement suggestions

Signed-off-by: Fabrice Flore-Thébault <ffloreth@redhat.com>

* docs: implement suggestions

Signed-off-by: Fabrice Flore-Thébault <ffloreth@redhat.com>

* Update website/docs/getting-started/pulling-an-image.md

Co-authored-by: Jeff MAURY <jmaury@redhat.com>
Signed-off-by: Fabrice Flore-Thébault <ffloreth@redhat.com>

* Update website/docs/getting-started/pulling-an-image.md

Signed-off-by: Fabrice Flore-Thébault <ffloreth@redhat.com>

* Update website/docs/getting-started/pulling-an-image.md

Signed-off-by: Fabrice Flore-Thébault <ffloreth@redhat.com>

* Update website/docs/getting-started/pulling-an-image.md

Co-authored-by: Florent BENOIT <fbenoit@redhat.com>
Signed-off-by: Fabrice Flore-Thébault <ffloreth@redhat.com>

---------

Signed-off-by: Fabrice Flore-Thébault <ffloreth@redhat.com>
Co-authored-by: Jeff MAURY <jmaury@redhat.com>
Co-authored-by: Florent BENOIT <fbenoit@redhat.com>
This commit is contained in:
Fabrice Flore-Thébault 2023-06-22 15:34:58 +02:00 committed by GitHub
parent 0dbe39381e
commit bb60249e04
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -0,0 +1,37 @@
---
sidebar_position: 2
title: Pulling an image
description: Pulling an image to your container engine.
keywords: [podman desktop, podman, containers, images]
tags: [images]
---
# Pulling an image to your container engine
With Podman Desktop, you can pull an image from a registry, to your container engine.
#### Prerequisites
- The image is available in a registry.
- If the registry or the image are not publicly available, you configured access to the registry on Podman Desktop in **<icon icon="fa-solid fa-cog" size="lg" /> Settings > Registries**.
#### Procedure
1. Go to **<icon icon="fa-solid fa-cloud" size="lg" /> Images**.
1. Click **<icon icon="fa-solid fa-arrow-circle-down" size="lg" /> Pull an image**.
1. On the **Image to Pull** screen:
1. **Image to pull**: enter the image name, such as `quay.io/podman/hello`. Prefer the fully qualified image name that specifies the registry, to the short name that might lead to registry resolution mistakes.
2. Click **Pull image**.
1. Click **Done**.
#### Verification
1. Go to **<icon icon="fa-solid fa-cloud" size="lg" /> Images**.
1. Click the image name you pulled, such as `quay.io/podman/hello`. Podman Desktop always displays the fully qualified image name.
1. Go to **Summary**.
1. Go to **History**.
1. Click the output area.
1. Enter <kbd>Ctrl</kbd> + <kbd>F</kbd> on Windows and Linux, or <kbd></kbd> + <kbd>F</kbd> on macOS to start searching in the content.
1. Go to **Inspect**.
1. Click the output area.
1. Enter <kbd>Ctrl</kbd> + <kbd>F</kbd> on Windows and Linux, or <kbd></kbd> + <kbd>F</kbd> on macOS to start searching in the content.