mirror of https://github.com/docker/docs.git
ENGDOCS-1875 (#18788)
* ENGDOCS-1875 * another admin setting * fix table formatting * review edits
This commit is contained in:
parent
71c6d2d88a
commit
f4376ff8a0
|
|
@ -40,6 +40,7 @@ Using the `admin-settings.json` file, admins can:
|
||||||
- Turn off Docker Desktop's ability to checks for updates
|
- Turn off Docker Desktop's ability to checks for updates
|
||||||
- Turn off Docker Extensions
|
- Turn off Docker Extensions
|
||||||
- Turn off Docker Scout SBOM indexing
|
- Turn off Docker Scout SBOM indexing
|
||||||
|
- Turn off beta and experimental features
|
||||||
|
|
||||||
For more details on the syntax and options admins can set, see [Configure Settings Management](configure.md).
|
For more details on the syntax and options admins can set, see [Configure Settings Management](configure.md).
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -106,13 +106,25 @@ The following `admin-settings.json` code and table provides an example of the re
|
||||||
"value": true
|
"value": true
|
||||||
},
|
},
|
||||||
"extensionsEnabled": {
|
"extensionsEnabled": {
|
||||||
"value": false,
|
"locked": true,
|
||||||
"locked": true
|
"value": false
|
||||||
},
|
},
|
||||||
"scout": {
|
"scout": {
|
||||||
"locked": false,
|
"locked": false,
|
||||||
"sbomIndexing": true,
|
"sbomIndexing": true,
|
||||||
"useBackgroundIndexing": true
|
"useBackgroundIndexing": true
|
||||||
|
},
|
||||||
|
"allowExperimentalFeatures": {
|
||||||
|
"locked": false,
|
||||||
|
"value": false
|
||||||
|
},
|
||||||
|
"allowBetaFeatures": {
|
||||||
|
"locked": false,
|
||||||
|
"value": false
|
||||||
|
},
|
||||||
|
"blockDockerLoad": {
|
||||||
|
"locked": false,
|
||||||
|
"value": true
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
@ -135,6 +147,9 @@ The following `admin-settings.json` code and table provides an example of the re
|
||||||
|`analyticsEnabled`| |If `value` is set to false, Docker Desktop doesn't send usage statistics to Docker. |
|
|`analyticsEnabled`| |If `value` is set to false, Docker Desktop doesn't send usage statistics to Docker. |
|
||||||
|`extensionsEnabled`| |If `value` is set to false, Docker extensions are disabled. |
|
|`extensionsEnabled`| |If `value` is set to false, Docker extensions are disabled. |
|
||||||
|`scout`|| Setting `useBackgroundIndexing` to `false` disables automatic indexing of images loaded to the image store. Setting `sbomIndexing` to `false` prevents the manual indexing triggered by inspecting an image in Docker Desktop.<br><br>**Note**: Users can still use the `docker scout` CLI commands to index images, even if indexing is disabled in Settings Management. |
|
|`scout`|| Setting `useBackgroundIndexing` to `false` disables automatic indexing of images loaded to the image store. Setting `sbomIndexing` to `false` prevents the manual indexing triggered by inspecting an image in Docker Desktop.<br><br>**Note**: Users can still use the `docker scout` CLI commands to index images, even if indexing is disabled in Settings Management. |
|
||||||
|
| `allowExperimentalFeatures`| | If `value` is set to `false`, experimental features are disabled.|
|
||||||
|
| `allowBetaFeatures`| | If `value` is set to `false`, beta features are disabled.|
|
||||||
|
| `blockDockerLoad` | | If `value` is set to `true`, users are no longer able to run [`docker load`](../../../engine/reference/commandline/load.md) and receive an error if they try to.|
|
||||||
|
|
||||||
### Step three: Re-launch Docker Desktop
|
### Step three: Re-launch Docker Desktop
|
||||||
>**Note**
|
>**Note**
|
||||||
|
|
|
||||||
|
|
@ -18,10 +18,13 @@ You can also locate the `settings.json` file at `~/.docker/desktop/settings.json
|
||||||
|
|
||||||
On the **General** tab, you can configure when to start Docker and specify other settings:
|
On the **General** tab, you can configure when to start Docker and specify other settings:
|
||||||
|
|
||||||
- **Start Docker Desktop when you log in**. Select to automatically start Docker
|
- **Start Docker Desktop when you sign in**. Select to automatically start Docker
|
||||||
Desktop when you sign in to your machine.
|
Desktop when you sign in to your machine.
|
||||||
|
|
||||||
- **Choose Theme for Docker Desktop**. Choose whether you want to apply a **Light** or **Dark** theme to Docker Desktop. Alternatively you can set Docker Desktop to **Use System Settings**.
|
- **Open Docker Dashboard when Docker Desktop starts**. Select to automatically open the
|
||||||
|
dashboard when starting Docker Desktop.
|
||||||
|
|
||||||
|
- **Choose theme for Docker Desktop**. Choose whether you want to apply a **Light** or **Dark** theme to Docker Desktop. Alternatively you can set Docker Desktop to **Use System Settings**.
|
||||||
|
|
||||||
- **Choose container terminal**. Determines which terminal is launched when opening the terminal from a container.
|
- **Choose container terminal**. Determines which terminal is launched when opening the terminal from a container.
|
||||||
If you choose the integrated terminal, you can run commands in a running container straight from the Docker Dashboard. For more information, see [Explore containers](../use-desktop/container.md).
|
If you choose the integrated terminal, you can run commands in a running container straight from the Docker Dashboard. For more information, see [Explore containers](../use-desktop/container.md).
|
||||||
|
|
@ -34,9 +37,6 @@ If you choose the integrated terminal, you can run commands in a running contain
|
||||||
- **Show weekly tips**. Select to display useful advice and suggestions about
|
- **Show weekly tips**. Select to display useful advice and suggestions about
|
||||||
using Docker.
|
using Docker.
|
||||||
|
|
||||||
- **Open Docker Desktop dashboard at startup**. Select to automatically open the
|
|
||||||
dashboard when starting Docker Desktop.
|
|
||||||
|
|
||||||
- **Use Enhanced Container Isolation**. Select to enhance security by preventing containers from breaching the Linux VM. For more information, see [Enhanced Container Isolation](../hardened-desktop/enhanced-container-isolation/index.md)
|
- **Use Enhanced Container Isolation**. Select to enhance security by preventing containers from breaching the Linux VM. For more information, see [Enhanced Container Isolation](../hardened-desktop/enhanced-container-isolation/index.md)
|
||||||
>**Note**
|
>**Note**
|
||||||
>
|
>
|
||||||
|
|
|
||||||
|
|
@ -23,10 +23,13 @@ You can also locate the `settings.json` file at `~/Library/Group Containers/grou
|
||||||
|
|
||||||
On the **General** tab, you can configure when to start Docker and specify other settings:
|
On the **General** tab, you can configure when to start Docker and specify other settings:
|
||||||
|
|
||||||
- **Start Docker Desktop when you log in**. Select to automatically start Docker
|
- **Start Docker Desktop when you sign in**. Select to automatically start Docker
|
||||||
Desktop when you sign in to your machine.
|
Desktop when you sign in to your machine.
|
||||||
|
|
||||||
- **Choose Theme for Docker Desktop**. Choose whether you want to apply a **Light** or **Dark** theme to Docker Desktop. Alternatively you can set Docker Desktop to **Use System Settings**.
|
- **Open Docker Dashboard when Docker Desktop starts**. Select to automatically open the
|
||||||
|
dashboard when starting Docker Desktop.
|
||||||
|
|
||||||
|
- **Choose theme for Docker Desktop**. Choose whether you want to apply a **Light** or **Dark** theme to Docker Desktop. Alternatively you can set Docker Desktop to **Use System Settings**.
|
||||||
|
|
||||||
- **Choose container terminal**. Determines which terminal is launched when opening the terminal from a container.
|
- **Choose container terminal**. Determines which terminal is launched when opening the terminal from a container.
|
||||||
If you choose the integrated terminal, you can run commands in a running container straight from the Docker Dashboard. For more information, see [Explore containers](../use-desktop/container.md).
|
If you choose the integrated terminal, you can run commands in a running container straight from the Docker Dashboard. For more information, see [Explore containers](../use-desktop/container.md).
|
||||||
|
|
@ -46,7 +49,6 @@ If you choose the integrated terminal, you can run commands in a running contain
|
||||||
> Use VirtioFS for speedy file sharing. VirtioFS has reduced the time taken to complete filesystem operations by [up to 98%](https://github.com/docker/roadmap/issues/7#issuecomment-1044452206)
|
> Use VirtioFS for speedy file sharing. VirtioFS has reduced the time taken to complete filesystem operations by [up to 98%](https://github.com/docker/roadmap/issues/7#issuecomment-1044452206)
|
||||||
{ .tip }
|
{ .tip }
|
||||||
|
|
||||||
|
|
||||||
- **Use Rosetta for x86/AMD64 emulation on Apple Silicon**. Turns on Rosetta to accelerate x86/AMD64 binary emulation on Apple Silicon. This option is only available if you have turned on **Virtualization framework** in the **General** settings tab. You must also be on macOS Ventura or later.
|
- **Use Rosetta for x86/AMD64 emulation on Apple Silicon**. Turns on Rosetta to accelerate x86/AMD64 binary emulation on Apple Silicon. This option is only available if you have turned on **Virtualization framework** in the **General** settings tab. You must also be on macOS Ventura or later.
|
||||||
|
|
||||||
- **Send usage statistics**. Select so Docker Desktop sends diagnostics,
|
- **Send usage statistics**. Select so Docker Desktop sends diagnostics,
|
||||||
|
|
@ -57,9 +59,6 @@ If you choose the integrated terminal, you can run commands in a running contain
|
||||||
- **Show weekly tips**. Select to display useful advice and suggestions about
|
- **Show weekly tips**. Select to display useful advice and suggestions about
|
||||||
using Docker.
|
using Docker.
|
||||||
|
|
||||||
- **Open Docker Desktop dashboard at startup**. Select to automatically open the
|
|
||||||
dashboard when starting Docker Desktop.
|
|
||||||
|
|
||||||
- **Use Enhanced Container Isolation**. Select to enhance security by preventing containers from breaching the Linux VM. For more information, see [Enhanced Container Isolation](../hardened-desktop/enhanced-container-isolation/index.md).
|
- **Use Enhanced Container Isolation**. Select to enhance security by preventing containers from breaching the Linux VM. For more information, see [Enhanced Container Isolation](../hardened-desktop/enhanced-container-isolation/index.md).
|
||||||
>**Note**
|
>**Note**
|
||||||
>
|
>
|
||||||
|
|
@ -199,6 +198,8 @@ The HTTPS proxy settings used for scanning images are set using the `HTTPS_PROXY
|
||||||
|
|
||||||
{{< include "desktop-network-setting.md" >}}
|
{{< include "desktop-network-setting.md" >}}
|
||||||
|
|
||||||
|
You can also select **Use kernel networking for UDP**. This lets you use a more efficient kernel networking path for UDP by changing the value of `kernelForUDP` in the `settings.json` file.
|
||||||
|
|
||||||
## Docker Engine
|
## Docker Engine
|
||||||
|
|
||||||
The **Docker Engine** tab allows you to configure the Docker daemon used to run containers with Docker Desktop.
|
The **Docker Engine** tab allows you to configure the Docker daemon used to run containers with Docker Desktop.
|
||||||
|
|
|
||||||
|
|
@ -18,12 +18,16 @@ You can also locate the `settings.json` file at `C:\Users\[USERNAME]\AppData\Roa
|
||||||
|
|
||||||
On the **General** tab, you can configure when to start Docker and specify other settings:
|
On the **General** tab, you can configure when to start Docker and specify other settings:
|
||||||
|
|
||||||
- **Start Docker Desktop when you log in**. Select to automatically start Docker
|
- **Start Docker Desktop when you sign in**. Select to automatically start Docker
|
||||||
Desktop when you sign in to your machine.
|
Desktop when you sign in to your machine.
|
||||||
|
|
||||||
- **Choose Theme for Docker Desktop**. Choose whether you want to apply a **Light** or **Dark** theme to Docker Desktop. Alternatively you can set Docker Desktop to **Use System Settings**.
|
- **Open Docker Dashboard when Docker Desktop starts**. Select to automatically open the
|
||||||
|
dashboard when starting Docker Desktop.
|
||||||
|
|
||||||
- **Use integrated container terminal**. Select to execute commands in a running container straight from the Docker Dashboard. For more information, see [Explore containers](../use-desktop/container.md).
|
- **Choose theme for Docker Desktop**. Choose whether you want to apply a **Light** or **Dark** theme to Docker Desktop. Alternatively you can set Docker Desktop to **Use System Settings**.
|
||||||
|
|
||||||
|
- **Choose container terminal**. Determines which terminal is launched when opening the terminal from a container.
|
||||||
|
If you choose the integrated terminal, you can run commands in a running container straight from the Docker Dashboard. For more information, see [Explore containers](../use-desktop/container.md).
|
||||||
|
|
||||||
- **Expose daemon on tcp://localhost:2375 without TLS**. Check this option to
|
- **Expose daemon on tcp://localhost:2375 without TLS**. Check this option to
|
||||||
enable legacy clients to connect to the Docker daemon. You must use this option
|
enable legacy clients to connect to the Docker daemon. You must use this option
|
||||||
|
|
@ -43,9 +47,6 @@ On the **General** tab, you can configure when to start Docker and specify other
|
||||||
- **Show weekly tips**. Select to display useful advice and suggestions about
|
- **Show weekly tips**. Select to display useful advice and suggestions about
|
||||||
using Docker.
|
using Docker.
|
||||||
|
|
||||||
- **Open Docker Desktop dashboard at startup**. Select to automatically open the
|
|
||||||
dashboard when starting Docker Desktop.
|
|
||||||
|
|
||||||
- **Use Enhanced Container Isolation**. Select to enhance security by preventing containers from breaching the Linux VM. For more information, see [Enhanced Container Isolation](../hardened-desktop/enhanced-container-isolation/index.md)
|
- **Use Enhanced Container Isolation**. Select to enhance security by preventing containers from breaching the Linux VM. For more information, see [Enhanced Container Isolation](../hardened-desktop/enhanced-container-isolation/index.md)
|
||||||
>**Note**
|
>**Note**
|
||||||
>
|
>
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
---
|
---
|
||||||
title: Explore Builds (Beta)
|
title: Explore Builds
|
||||||
description: Understand how to use the Builds view in Docker Desktop
|
description: Understand how to use the Builds view in Docker Desktop
|
||||||
keywords: Docker Dashboard, manage, gui, dashboard, builders, builds
|
keywords: Docker Dashboard, manage, gui, dashboard, builders, builds
|
||||||
---
|
---
|
||||||
|
|
|
||||||
|
|
@ -1139,7 +1139,7 @@ Manuals:
|
||||||
- path: /desktop/use-desktop/volumes/
|
- path: /desktop/use-desktop/volumes/
|
||||||
title: Explore Volumes
|
title: Explore Volumes
|
||||||
- path: /desktop/use-desktop/builds/
|
- path: /desktop/use-desktop/builds/
|
||||||
title: Explore Builds (Beta)
|
title: Explore Builds
|
||||||
- path: /desktop/use-desktop/resource-saver/
|
- path: /desktop/use-desktop/resource-saver/
|
||||||
title: Resource Saver mode
|
title: Resource Saver mode
|
||||||
- path: /desktop/use-desktop/pause/
|
- path: /desktop/use-desktop/pause/
|
||||||
|
|
@ -1253,6 +1253,8 @@ Manuals:
|
||||||
title: Manage non-Marketplace extensions
|
title: Manage non-Marketplace extensions
|
||||||
- path: /desktop/extensions/settings-feedback/
|
- path: /desktop/extensions/settings-feedback/
|
||||||
title: Change settings and give feedback
|
title: Change settings and give feedback
|
||||||
|
- path: /desktop/extensions/private-marketplace/
|
||||||
|
title: Configure a private marketplace (Beta)
|
||||||
- sectiontitle: Extensions SDK
|
- sectiontitle: Extensions SDK
|
||||||
section:
|
section:
|
||||||
- path: /desktop/extensions-sdk/
|
- path: /desktop/extensions-sdk/
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue