From 7bebdfbad08fd81298853175e975f0ca31a8a068 Mon Sep 17 00:00:00 2001 From: andrewb-ontheinternet <148912128+andrewb-ontheinternet@users.noreply.github.com> Date: Thu, 5 Feb 2026 11:42:54 -0500 Subject: [PATCH 1/2] kubernetes: revise required kubeadm images Update Kubernetes images pulled by Docker Desktop during a kubeadm installation --- .../manuals/desktop/use-desktop/kubernetes.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/content/manuals/desktop/use-desktop/kubernetes.md b/content/manuals/desktop/use-desktop/kubernetes.md index ece85d88a8a3..782c912b01b9 100644 --- a/content/manuals/desktop/use-desktop/kubernetes.md +++ b/content/manuals/desktop/use-desktop/kubernetes.md @@ -136,16 +136,16 @@ docker.io/docker/desktop-containerd-registry-mirror: In `kubeadm` mode it requires the following images: ```console -docker.io/registry.k8s.io/kube-controller-manager: -docker.io/registry.k8s.io/kube-apiserver: -docker.io/registry.k8s.io/kube-scheduler: -docker.io/registry.k8s.io/kube-proxy -docker.io/registry.k8s.io/etcd: -docker.io/registry.k8s.io/pause: -docker.io/registry.k8s.io/coredns/coredns: +docker.io/docker/desktop-kubernetes: docker.io/docker/desktop-storage-provisioner: docker.io/docker/desktop-vpnkit-controller: -docker.io/docker/desktop-kubernetes: +docker.io/docker/desktop-kubernetes-etcd: +docker.io/docker/desktop-kubernetes-coredns: +docker.io/docker/desktop-kubernetes-pause: +docker.io/docker/desktop-kubernetes-apiserver: +docker.io/docker/desktop-kubernetes-controller-manager: +docker.io/docker/desktop-kubernetes-scheduler: +docker.io/docker/desktop-kubernetes-proxy: ``` The image tags are automatically selected by Docker Desktop based on several From 784a60d5ec1d59d99b5e7543346d169b0fffd200 Mon Sep 17 00:00:00 2001 From: andrewb-ontheinternet <148912128+andrewb-ontheinternet@users.noreply.github.com> Date: Thu, 5 Feb 2026 17:04:21 +0000 Subject: [PATCH 2/2] kubernetes: reference desktop kuberenetes CLI to list images --- content/manuals/desktop/use-desktop/kubernetes.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/content/manuals/desktop/use-desktop/kubernetes.md b/content/manuals/desktop/use-desktop/kubernetes.md index 782c912b01b9..7f1c8a940c3f 100644 --- a/content/manuals/desktop/use-desktop/kubernetes.md +++ b/content/manuals/desktop/use-desktop/kubernetes.md @@ -151,6 +151,11 @@ docker.io/docker/desktop-kubernetes-proxy: The image tags are automatically selected by Docker Desktop based on several 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. +> [!NOTE] +> +> 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. +> See the [docker desktop](/reference/cli/docker/desktop/kubernetes/images) CLI reference for more details. + To accommodate scenarios where access to Docker Hub is not allowed, admins can configure Docker Desktop to pull the above listed images from a different registry (e.g., a mirror) 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. The recommended approach to set this up is the following: 1. Start Kubernetes using the desired cluster provisioning method: `kubeadm` or `kind`. -2. Once Kubernetes has started, use `docker ps` to view the container images used by Docker Desktop for the Kubernetes control plane. +2. After Kubernetes has started, use either: + - (Docker Desktop v4.44 or later) `docker desktop kubernetes images list` to list the image tags that will be pulled by the current Docker Desktop installation + - `docker ps` to view the container images used by Docker Desktop for the Kubernetes control plane 3. Clone or mirror those images (with matching tags) to your custom registry. 4. Stop the Kubernetes cluster. 5. Configure the `KubernetesImagesRepository` setting to point to your custom registry.