Skip to content

Commit 5d24bad

Browse files
Settings differences (docker#11002)
* Describe which settings are available with which backend * Minor style updates Co-authored-by: Usha Mandya <[email protected]>
1 parent f91c2a2 commit 5d24bad

File tree

1 file changed

+40
-2
lines changed

1 file changed

+40
-2
lines changed

docker-for-windows/index.md

Lines changed: 40 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -205,12 +205,22 @@ troubleshoot the application. Clear the check box to opt out. Docker may periodi
205205
206206
### Resources
207207
208-
The **Resources** tab allows you to configure CPU, memory, disk, proxies, network, and other resources.
208+
The **Resources** tab allows you to configure CPU, memory, disk, proxies,
209+
network, and other resources. Different settings are available for
210+
configuration depending on whether you are using Linux containers in WSL 2
211+
mode, Linux containers in Hyper-V mode, or Windows containers.
209212
210213
![Resources](images/settings-resources.png){:width="750px"}
211214
212215
#### Advanced
213216
217+
> **Note**
218+
>
219+
> The Advanced tab is only available in Hyper-V mode, because in WSL 2 mode and
220+
> Windows container mode these resources are managed by Windows. In WSL 2
221+
> mode, you can configure limits on the memory, CPU, and swap size allocated
222+
> to the [WSL 2 utility VM](https://docs.microsoft.com/en-us/windows/wsl/release-notes#build-18945).
223+
214224
Use the **Advanced** tab to limit resources available to Docker.
215225
216226
**CPUs**: By default, Docker Desktop is set to use half the number of processors
@@ -230,10 +240,14 @@ You can also move the disk image to a different location. If you attempt to move
230240
231241
#### File sharing
232242
243+
> **Note**
244+
>
245+
> The File sharing tab is only available in Hyper-V mode, because in WSL 2 mode
246+
> and Windows container mode all files are automatically shared by Windows.
247+
233248
Use File sharing to allow local drives on Windows to be shared with Linux containers.
234249
This is especially useful for
235250
editing source code in an IDE on the host while running and testing the code in a container.
236-
Note that configuring file sharing is not necessary for Windows containers, only [Linux containers](#switch-between-windows-and-linux-containers).
237251
If a drive is not shared with a Linux container you may get `file not found` or `cannot start service` errors at runtime. See [Volume mounting requires shared drives for Linux containers](troubleshoot.md#volume-mounting-requires-shared-drives-for-linux-containers).
238252
239253
**Apply & Restart** makes the drives available to containers using Docker's bind mount (`-v`) feature.
@@ -292,6 +306,11 @@ to keep running across restarts, you should consider using
292306
293307
#### Network
294308
309+
> **Note**
310+
>
311+
> The Network tab is not available in Windows container mode because networking is
312+
> managed by Windows.
313+
295314
You can configure Docker Desktop networking to work on a virtual private network (VPN). Specify a network address translation (NAT) prefix and subnet mask to enable Internet connectivity.
296315
297316
**DNS Server**: You can configure the DNS server to use dynamic or static IP addressing.
@@ -305,6 +324,21 @@ You can configure Docker Desktop networking to work on a virtual private network
305324
306325
Updating these settings requires a reconfiguration and reboot of the Linux VM.
307326
327+
#### WSL Integration
328+
329+
In WSL 2 mode, you can configure which WSL 2 distributions will have the Docker
330+
WSL integration.
331+
332+
By default, the integration will be enabled on your default WSL distribution.
333+
To change your default WSL distro, run `wsl --set-default <distro name>`. (For example,
334+
to set Ubuntu as your default WSL distro, run `wsl --set-default ubuntu`).
335+
336+
You can also select any additional distributions you would like to enable the WSL 2
337+
integration on.
338+
339+
For more details on configuring Docker Desktop to use WSL 2, see
340+
[Docker Desktop WSL 2 backend](wsl.md).
341+
308342
### Docker Engine
309343
310344
The Docker Engine page allows you to configure the Docker daemon to determine how your containers run.
@@ -366,6 +400,10 @@ Server: Docker Engine - Community
366400
367401
### Kubernetes
368402
403+
> **Note**
404+
>
405+
> The Kubernetes tab is not available in Windows container mode.
406+
369407
Docker Desktop includes a standalone Kubernetes server that runs on your Windows host, so that you can test deploying your Docker workloads on Kubernetes.
370408
371409
![Enable Kubernetes](images/settings-kubernetes.png){:width="750px"}

0 commit comments

Comments
 (0)