Skip to content

Commit 5cae97b

Browse files
kubernetes: reference desktop kuberenetes CLI to list images
1 parent 7bebdfb commit 5cae97b

File tree

1 file changed

+8
-1
lines changed

1 file changed

+8
-1
lines changed

content/manuals/desktop/use-desktop/kubernetes.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -151,6 +151,11 @@ docker.io/docker/desktop-kubernetes-proxy:<tag>
151151
The image tags are automatically selected by Docker Desktop based on several
152152
factors, including the version of Kubernetes being used. The tags vary for each image and may change between Docker Desktop releases. To stay informed, monitor the Docker Desktop release notes.
153153

154+
> [!NOTE]
155+
>
156+
> In Docker Desktop versions 4.44 or later you can run `docker desktop kubernetes images list` to list Kubernetes images used by the currently installed version of Docker Desktop.
157+
> See the [docker desktop](/reference/cli/docker/desktop/kubernetes/images) CLI reference for more details.
158+
154159
To accommodate scenarios where access to Docker Hub is not allowed, admins can
155160
configure Docker Desktop to pull the above listed images from a different registry (e.g., a mirror)
156161
using the [KubernetesImagesRepository](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md#kubernetes) setting as follows.
@@ -176,7 +181,9 @@ also match what Docker Desktop expects.
176181
The recommended approach to set this up is the following:
177182

178183
1. Start Kubernetes using the desired cluster provisioning method: `kubeadm` or `kind`.
179-
2. Once Kubernetes has started, use `docker ps` to view the container images used by Docker Desktop for the Kubernetes control plane.
184+
2. After Kubernetes has started, use either:
185+
- `docker desktop kubernetes images list` to list the image tags that will be pulled by the current Docker Desktop installation (Docker Desktop v4.44+)
186+
- `docker ps` to view the container images used by Docker Desktop for the Kubernetes control plane
180187
3. Clone or mirror those images (with matching tags) to your custom registry.
181188
4. Stop the Kubernetes cluster.
182189
5. Configure the `KubernetesImagesRepository` setting to point to your custom registry.

0 commit comments

Comments
 (0)