You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/manuals/security/for-admins/hardened-desktop/settings-management/settings-reference.md
+40Lines changed: 40 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -621,6 +621,12 @@ Builders settings lets you manage Buildx builder instances for advanced image-bu
621
621
>
622
622
> In hardened environments, disable and lock this setting.
623
623
624
+
> [!IMPORTANT]
625
+
>
626
+
> When Kubernetes is enabled through Settings Management policies, only the
627
+
`kubeadm` cluster provisioning method is supported. The `kind` provisioning
628
+
method is not yet supported by Settings Management.
629
+
624
630
-**Configure this setting with:**
625
631
-**Kubernetes** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
626
632
- Settings Management: `kubernetes` setting in the [`admin-settings.json` file](/manuals/security/for-admins/hardened-desktop/settings-management/configure-json-file.md)
@@ -680,6 +686,40 @@ compatibility.
680
686
-**Configure this setting with:**
681
687
-**Kubernetes** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
682
688
689
+
### Custom Kubernetes image repository
690
+
691
+
| Default value | Accepted values | Format |
692
+
|---------------|-----------------|----------|
693
+
|`""`| Registry URL | String |
694
+
695
+
-**Description**: Configure a custom image repository for Kubernetes control
696
+
plane images. This allows Docker Desktop to pull Kubernetes system
697
+
images from a private registry or mirror instead of Docker Hub. This setting
698
+
overrides the `[registry[:port]/][namespace]` portion of image names.
699
+
-**OS**: {{< badge color=blue text="All" >}}
700
+
-**Use case**: Use private registries in air-gapped environments or
701
+
when Docker Hub access is restricted.
702
+
703
+
> [!NOTE]
704
+
>
705
+
> The images must be cloned/mirrored from Docker Hub with matching tags. The
706
+
specific images required depend on the cluster provisioning method (`kubeadm`
707
+
or `kind`). See the Kubernetes documentation for the complete list
708
+
of required images and detailed setup instructions.
709
+
710
+
-**Configure this setting with**:
711
+
- Settings Management: `KubernetesImagesRepository` settings in the
0 commit comments