engine: add page for the windowsfilter storage driver

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
This commit is contained in:
David Karlsson 2024-12-17 12:48:06 +01:00
parent 1f9cfb5040
commit 7ff0050ec2
4 changed files with 49 additions and 4 deletions

View File

@ -72,6 +72,7 @@ exceptions:
- NET
- NFS
- NOTE
- NTFS
- NTLM
- NVDA
- OCI

View File

@ -183,3 +183,4 @@ userland
untrusted
vSphere
vpnkit
windowsfilter

View File

@ -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)

View File

@ -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).