Skip to content

freshness: DD setting section #26198

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
aevesdocker merged 3 commits into from
Sep 28, 2026
+39 −13
Merged

freshness: DD setting section #26198

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
a83e64a
freshness: DD setting section
aevesdocker Sep 28, 2026
b11cfa9
wpad note
aevesdocker Sep 28, 2026
d648a9a
review
aevesdocker Sep 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 28 additions & 9 deletions content/manuals/desktop/settings-and-maintenance/backup-and-restore.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Use this procedure to back up and restore your images and container data. This i

If you used a [named volume](/manuals/engine/storage/_index.md#more-details-about-mount-types) to store container data, such as databases, refer to the [back up, restore, or migrate data volumes](/manuals/engine/storage/volumes.md#back-up-restore-or-migrate-data-volumes) page in the storage section.

2. Use [`docker push`](/reference/cli/docker/image/push/) to push any
1. Use [`docker push`](/reference/cli/docker/image/push/) to push any
images you have built locally and want to keep to the [Docker Hub registry](/manuals/docker-hub/_index.md).

> [!TIP]
Expand Down Expand Up @@ -57,7 +57,7 @@ and [install a different version](/manuals/desktop/release-notes.md) or reset Do
$ docker image load -i images.tar
```

2. Re-create your containers if needed, using [`docker run`](/reference/cli/docker/container/run/),
1. Re-create your containers if needed, using [`docker run`](/reference/cli/docker/container/run/),
or [Docker Compose](/manuals/compose/_index.md).

To restore volume data, refer to [backup, restore, or migrate data volumes](/manuals/engine/storage/volumes.md#back-up-restore-or-migrate-data-volumes).
Expand All @@ -66,26 +66,45 @@ To restore volume data, refer to [backup, restore, or migrate data volumes](/man

If Docker Desktop cannot launch and must be reinstalled, you can back up its VM disk and image data directly from disk. Docker Desktop must be fully stopped before backing up these files.

> [!NOTE]
>
> The paths below are the default locations. If you've customized the
> **Disk image location** setting (**Settings** > **Resources** > **Advanced**),
> back up the file at your configured location instead.

{{< tabs >}}
{{< tab name="Windows" >}}

Docker Desktop on Windows stores VM data in a different location depending on
which backend you're using. Check **Settings** > **General** > **Choose
Virtual Machine Manager (VMM)** to see which one applies to you.

1. Back up Docker containers/images.

Backup the following file:
For WSL 2, back up the following file:

```console
%LOCALAPPDATA%\Docker\wsl\data\docker_data.vhdx
%LOCALAPPDATA%\Docker\wsl\disk\docker_data.vhdx
```

Copy it to a safe location.
If you're running any WSL Linux distributions (Ubuntu, Alpine, etc.), back
them up separately using [Microsoft's guide](https://learn.microsoft.com/en-us/windows/wsl/export-import).

For Hyper-V, back up the following file:

1. Back up WSL distributions.
```console
%ProgramData%\DockerDesktop\vm-data\DockerDesktop.vhdx
```

If you're running any WSL Linux distributions (Ubuntu, Alpine, etc.), back them up using [Microsoft's guide](https://learn.microsoft.com/en-us/windows/wsl/faq#how-can-i-back-up-my-wsl-distributions-).
For Docker VMM (Beta), back up the following file:

1. Restore.
```console
%LOCALAPPDATA%\Docker\vm-data\DockerDesktop.vhdx
```

1. Copy your back-up to a safe location.

After reinstalling Docker Desktop, restore the `docker_data.vhdx` to the same location and re-import your WSL distributions if needed.
1. After reinstalling Docker Desktop, restore the `.vhdx` file to the same location for your backend, and re-import your WSL distributions if needed.

{{< /tab >}}
{{< tab name="Mac" >}}
Expand Down
15 changes: 11 additions & 4 deletions content/manuals/desktop/settings-and-maintenance/settings.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ Configure startup behavior, UI appearance, terminal preferences, and feature def
| **Open Docker Dashboard when Docker Desktop starts** | Automatically open the dashboard when starting Docker Desktop. | Disabled | All | |
| **Choose theme for Docker Desktop** | Apply a **Light** or **Dark** theme to Docker Desktop. | **Use system settings**. | All | |
| **Configure shell completions** | Edits your shell configuration to enable word completion for commands, flags, and Docker objects when you press `<Tab>` in your terminal. For more information, see [Completion](/manuals/engine/cli/completion.md). | Disabled | All | |
| **Choose container terminal** | Sets which terminal opens when you select a container terminal. Use the integrated terminal to run commands in a running container from the Dashboard. For more information, see [Explore containers](/manuals/desktop/use-desktop/container.md). | Disabled | All | |
| **Choose container terminal** | Sets which terminal opens when you select a container terminal. Use the integrated terminal to run commands in a running container from the Dashboard. For more information, see [Explore containers](/manuals/desktop/use-desktop/container.md). | Integrated | All | |
| **Enable Docker terminal**. | Interact with your host machine and execute commands directly from Docker Desktop. | Disabled | All | |
| **Enable Docker Debug by default** | Use Docker Debug by default opening the integrated terminal. For more information, see [Explore containers](/manuals/desktop/use-desktop/container.md#integrated-terminal). | Disabled | All | |
| **Include VM in Time Machine backups** | Back up the Docker Desktop virtual machine. | Disabled | Mac | |
Expand All @@ -45,8 +45,8 @@ Configure startup behavior, UI appearance, terminal preferences, and feature def
| **Use the WSL 2 based engine** | WSL 2 provides better performance than the Hyper-V backend. For more information, see [Docker Desktop WSL 2 backend](/manuals/desktop/features/wsl/_index.md). | Disabled | Windows | |
| **Add \*.docker.internal to host file** | Adds internal DNS entries. | Enabled | Windows | Helps resolve Docker-internal domains |
| **Choose Virtual Machine Manager (VMM)** | Choose the VMM for creating and managing the Docker Desktop Linux VM. For more information, see [Virtual Machine Manager](/manuals/desktop/features/vmm.md). | | Mac, Windows | Select **Docker VMM** for optimized container performance. Docker VMM is in Beta. |
| **Choose file sharing implementation for your containers** | Choose whether you want to share files using **VirtioFS**, or **gRPC FUSE** | **VirtioFS** | Mac | 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). It is the only file sharing implementation supported by Docker VMM. |
|**Use Rosetta for x86_64/amd64 emulation on Apple Silicon** | Accelerate x86/AMD64 binary emulation on Apple Silicon. This option is only available if you have selected **Apple Virtualization framework** as the Virtual Machine Manager. | Disabled | Mac | |
| **Choose file sharing implementation for your containers** (Available with the Apple Virtualization framework VMM) | Choose whether you want to share files using **VirtioFS**, or **gRPC FUSE** | **VirtioFS** | Mac | 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). It is the only file sharing implementation supported by Docker VMM. |
|**Use Rosetta for x86_64/amd64 emulation on Apple Silicon** (Available with the Apple Virtualization framework VMM) | Accelerate x86/AMD64 binary emulation on Apple Silicon. | Disabled | Mac | |
| **Send usage statistics** | Send diagnostics, crash reports, and usage data to Docker to improve and troubleshoot the application. Docker may periodically prompt you for more information. | Enabled | All | |
| **Use Enhanced Container Isolation** | Prevent containers from breaching the Linux VM. For more information, see [Enhanced Container Isolation](/manuals/enterprise/security/hardened-desktop/enhanced-container-isolation/_index.md). | Disabled | All | Must be signed in and have a Docker Business subscription. |
| **Show CLI hints** | Display helpful CLI suggestions in terminal. | Enabled | All | Improves discoverability |
Expand Down Expand Up @@ -131,6 +131,13 @@ Used for Docker Desktop host-level traffic: signing in to Docker, the Desktop ap
| **No proxy** | Connect directly without a proxy. |
| **Manual configuration** | Enter a **Web Server (HTTP)** and **Secure Web Server (HTTPS)** URL manually. Use the format `http://proxy:port` or `https://proxy:port`. You can also specify hosts and domains that should bypass the proxy, for example: `registry-1.docker.com,*.docker.com,10.0.0.0/8`. |

Docker Desktop reads a proxy or PAC URL that is statically configured on the
host. For example a manual proxy setting, a static PAC file URL, or a
GPO-managed override. WPAD (Web Proxy Auto-Discovery Protocol) auto-discovery
is untested on both Windows and Mac and isn't officially supported. If your
proxy is only discoverable via WPAD (DHCP option 252 or the `wpad.<domain>`
DNS convention), configure a static PAC URL or proxy address instead.

> [!NOTE]
>
> If you use a PAC file hosted on a web server, add the MIME type `application/x-ns-proxy-autoconfig` for the `.pac` extension. Without this, the PAC file may not parse correctly. See [Hardened Docker Desktop](/manuals/enterprise/security/hardened-desktop/air-gapped-containers.md#proxy-auto-configuration-files).
Expand Down Expand Up @@ -296,7 +303,7 @@ Manage how and when Docker Desktop checks for and downloads updates.
| ------------------- | ----------------------------------------- | ------------------------------------- |
| **Automatically check for updates** | Notifies you of available updates in the Docker menu and Dashboard footer. | Enabled |
| **Always download updates** | Automatically download new versions of Docker Desktop in the background. | Disabled |
| **Automatically update components** | Update Docker Desktop components (such as Docker Compose, Docker Scout, and the Docker CLI) independently, without a full restart. | Enabled |
| **Automatically update components** | Update Docker Desktop components (such as Docker Compose, Docker Scout, and the Docker CLI) independently, without a full restart. Available with Docker Desktop version 4.92 and earlier. | Enabled |

## Extensions

Expand Down