Merge pull request #21652 from dvdksn/windowsfilter

engine: add page for the windowsfilter storage driver

Author: dvdksn

_vale/Docker/Acronyms.yml

@@ -73,6 +73,7 @@ exceptions:
   - NET
   - NFS
   - NOTE
+  - NTFS
   - NTLM
   - NUMA
   - NVDA

_vale/config/vocabularies/Docker/accept.txt

@@ -186,3 +186,4 @@ ufw
 umask
 vSphere
 vpnkit
+windowsfilter

content/manuals/engine/storage/drivers/select-storage-driver.md

@@ -19,6 +19,12 @@ Docker host. After you have read the [storage driver overview](./_index.md), the
 next step is to choose the best storage driver for your workloads. Use the storage
 driver with the best overall performance and stability in the most usual scenarios.
 
+> [!NOTE]
+> This page discusses storage drivers for Docker Engine on Linux. If you're
+> running the Docker daemon with Windows as the host OS, the only supported
+> storage driver is windowsfilter. For more information, see
+> [windowsfilter](windowsfilter-driver.md).
+
 The Docker Engine provides the following storage drivers on Linux:
 
 | Driver            | Description                                                                                                                                                                                                                                                                                                                                          |
@@ -189,7 +195,8 @@ to physical or logical disks on the Docker host.
 
 ## Related information
 
-- [About images, containers, and storage drivers](./_index.md)
-- [`overlay2` storage driver in practice](overlayfs-driver.md)
-- [`btrfs` storage driver in practice](btrfs-driver.md)
-- [`zfs` storage driver in practice](zfs-driver.md)
+- [Storage drivers](./_index.md)
+- [`overlay2` storage driver](overlayfs-driver.md)
+- [`btrfs` storage driver](btrfs-driver.md)
+- [`zfs` storage driver](zfs-driver.md)
+- [`windowsfilter` storage driver](windowsfilter-driver.md)

content/manuals/engine/storage/drivers/windowsfilter-driver.md

@@ -0,0 +1,36 @@
+---
+description: Learn about the windowsfilter storage driver
+keywords: container, storage, driver, windows, windowsfilter
+title: windowsfilter storage driver
+---
+
+The windowsfilter storage driver is the default storage driver for Docker
+Engine on Windows. The windowsfilter driver uses Windows-native file system
+layers to for storing Docker layers and volume data on disk. The windowsfilter
+storage driver only works on file systems formatted with NTFS.
+
+## Configure the windowsfilter storage driver
+
+For most use case, no configuring the windowsfilter storage driver is not
+necessary.
+
+The default storage limit for Docker Engine on Windows is 127GB. To use a
+different storage size, set the `size` option for the windowsfilter storage
+driver. See [windowsfilter options](/reference/cli/dockerd.md#windowsfilter-options).
+
+Data is stored on the Docker host in `image` and `windowsfilter` subdirectories
+within `C:\ProgramData\docker` by default. You can change the storage location
+by configuring the `data-root` option in the [Daemon configuration file](/reference/cli/dockerd.md#on-windows):
+
+```json
+{
+  "data-root": "d:\\docker"
+}
+```
+
+You must restart the daemon for the configuration change to take effect.
+
+## Additional information
+
+For more information about how container storage works on Windows, refer to
+Microsoft's [Containers on Windows documentation](https://learn.microsoft.com/en-us/virtualization/windowscontainers/manage-containers/container-storage).