You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Use the following procedure to save and restore your images and container data. This is useful if you want to reset your VM disk or to move your Docker environment to a new
11
-
computer, for example.
11
+
Use this procedure to back up and restore your images and container data. This is useful if you want to reset your VM disk or to move your Docker environment to a new computer.
12
12
13
13
> [!IMPORTANT]
14
14
>
@@ -18,37 +18,44 @@ computer, for example.
18
18
19
19
1. Commit your containers to an image with [`docker container commit`](/reference/cli/docker/container/commit.md).
20
20
21
-
Committing a container stores the container filesystem changes and some of the
22
-
container's configuration, for example labels and environment-variables, as a local image. Be aware that environment variables may contain sensitive
23
-
information such as passwords or proxy-authentication, so care should be taken
24
-
when pushing the resulting image to a registry.
21
+
Committing a container stores filesystem changes and some container configurations, such as labels and environment variables, as a local image. Be aware that environment variables may contain sensitive
22
+
information such as passwords or proxy-authentication, so take care when pushing the resulting image to a registry.
25
23
26
-
Also note that filesystem changes in volume that are attached to the
24
+
Also note that filesystem changes in a volume that are attached to the
27
25
container are not included in the image, and must be backed up separately.
28
26
29
27
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.
30
28
31
29
2. Use [`docker push`](/reference/cli/docker/image/push.md) to push any
32
30
images you have built locally and want to keep to the [Docker Hub registry](/manuals/docker-hub/_index.md).
33
31
34
-
Make sure to configure the [repository's visibility as "private"](/manuals/docker-hub/repos/_index.md)
35
-
for images that should not be publicly accessible.
32
+
> [!TIP]
33
+
>
34
+
> [Set the repository visibility to private](/manuals/docker-hub/repos/_index.md) if your image includes sensitive content.
36
35
37
36
Alternatively, use [`docker image save -o images.tar image1 [image2 ...]`](/reference/cli/docker/image/save.md)
38
-
to save any images you want to keep to a local tar file.
37
+
to save any images you want to keep to a local `.tar` file.
39
38
40
39
After backing up your data, you can uninstall the current version of Docker Desktop
41
40
and [install a different version](/manuals/desktop/release-notes.md) or reset Docker Desktop to factory defaults.
42
41
43
42
## Restore your data
44
43
45
-
1. Use [`docker pull`](/reference/cli/docker/image/pull.md) to restore images
46
-
you pushed to Docker Hub.
44
+
1. Load your images.
47
45
48
-
If you backed up your images to a local tar file, use [`docker image load -i images.tar`](/reference/cli/docker/image/load.md)
49
-
to restore previously saved images.
46
+
- If you pushed to Docker Hub:
47
+
48
+
```console
49
+
$ docker pull <my-backup-image>
50
+
```
51
+
52
+
- If you saved a `.tar` file:
53
+
54
+
```console
55
+
$ docker image load -i images.tar
56
+
```
50
57
51
58
2. Re-create your containers if needed, using [`docker run`](/reference/cli/docker/container/run.md),
52
59
or [Docker Compose](/manuals/compose/_index.md).
53
60
54
-
Refer to the [backup, restore, or migrate data volumes](/manuals/engine/storage/volumes.md#back-up-restore-or-migrate-data-volumes) page in the storage section to restore volume data.
61
+
To restore volume data, refer to [backup, restore, or migrate data volumes](/manuals/engine/storage/volumes.md#back-up-restore-or-migrate-data-volumes).
Copy file name to clipboardExpand all lines: content/manuals/desktop/settings-and-maintenance/settings.md
+18-15Lines changed: 18 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,6 +34,8 @@ On the **General** tab, you can configure when to start Docker and specify other
34
34
35
35
-**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**.
36
36
37
+
-**Configure shell completions**. Automatically edits your shell configuration and gives you word completion for commands, flags, and Docker objects (such as container and volume names) when you hit `<Tab>` as you type into your terminal. For more information, see [Completion](/manuals/engine/cli/completion.md).
38
+
37
39
-**Choose container terminal**. Determines which terminal is launched when opening the terminal from a container.
38
40
If you choose the integrated terminal, you can run commands in a running container straight from the Docker Desktop Dashboard. For more information, see [Explore containers](/manuals/desktop/use-desktop/container.md).
39
41
@@ -44,6 +46,12 @@ If you choose the integrated terminal, you can run commands in a running contain
44
46
- {{< badge color=blue text="Mac only" >}}**Include VM in Time Machine backups**. Select to back up the Docker Desktop
45
47
virtual machine. This option is turned off by default.
46
48
49
+
-**Use containerd for pulling and storing images**.
50
+
Turns on the containerd image store.
51
+
This brings new features like faster container startup performance by lazy-pulling images,
52
+
and the ability to run Wasm applications with Docker.
53
+
For more information, see [containerd image store](/manuals/desktop/features/containerd.md).
54
+
47
55
- {{< badge color=blue text="Windows only" >}}**Expose daemon on tcp://localhost:2375 without TLS**. Check this option to
48
56
enable legacy clients to connect to the Docker daemon. You must use this option
49
57
with caution as exposing the daemon without TLS can result in remote code
@@ -54,12 +62,6 @@ If you choose the integrated terminal, you can run commands in a running contain
54
62
55
63
- {{< badge color=blue text="Windows only" >}}**Add the `*.docker.internal` names to the host's `/etc/hosts` file (Password required)**. Lets you resolve `*.docker.internal` DNS names from both the host and your containers.
56
64
57
-
-**Use containerd for pulling and storing images**.
58
-
Turns on the containerd image store.
59
-
This brings new features like faster container startup performance by lazy-pulling images,
60
-
and the ability to run Wasm applications with Docker.
61
-
For more information, see [containerd image store](/manuals/desktop/features/containerd.md).
62
-
63
65
- {{< badge color=blue text="Mac only" >}} **Choose Virtual Machine Manager (VMM)**. Choose the Virtual Machine Manager for creating and managing the Docker Desktop Linux VM.
64
66
- Select **Docker VMM** for the latest and most performant Hypervisor/Virtual Machine Manager. This option is available only on Apple Silicon Macs running macOS 12.5 or later and is currently in Beta.
65
67
> [!TIP]
@@ -88,7 +90,7 @@ If you choose the integrated terminal, you can run commands in a running contain
88
90
89
91
-**Show CLI hints**. Displays CLI hints and tips when running Docker commands in the CLI. This is turned on by default. To turn CLI hints on or off from the CLI, set `DOCKER_CLI_HINTS` to `true` or `false` respectively.
90
92
91
-
-**SBOM Indexing**. When this option is enabled, inspecting an image in Docker Desktop shows a **Start analysis** button that, when selected, analyzes the image with Docker Scout.
93
+
-**Enable Scout image analysis**. When this option is enabled, inspecting an image in Docker Desktop shows a **Start analysis** button that, when selected, analyzes the image with Docker Scout.
92
94
93
95
-**Enable background SBOM indexing**. When this option is enabled, Docker Scout automatically analyzes images that you build or pull.
94
96
@@ -128,7 +130,7 @@ Advanced settings are:
128
130
129
131
-**Swap**. Configure swap file size as needed. The default is 1 GB.
130
132
131
-
-**Virtual disk limit**. Specify the maximum size of the disk image.
133
+
-**Disk usage limit**. Specify the maximum amount of disk space the engine can use.
132
134
133
135
-**Disk image location**. Specify the location of the Linux volume where containers and images are stored.
134
136
@@ -429,8 +431,6 @@ With Docker Desktop version 4.38 and later, you can choose your cluster provisio
429
431
-**Kubeadm** creates a single-node cluster and the version is set by Docker Desktop.
430
432
-**kind** creates a multi-node cluster and you can set the version and number of nodes.
431
433
432
-
Docker Desktop version 4.38 and later also lets you install the Kubernetes Dashboard within an existing Kubernetes cluster with the **Deploy the Kubernetes Dashboard into cluster** setting. It provides real-time visibility into workloads and nodes and helps you manage and monitor your Kubernetes clusters and applications easily.
433
-
434
434
Select **Show system containers (advanced)** to view internal containers when
435
435
using Docker commands.
436
436
@@ -499,12 +499,15 @@ For a list of current experimental features in the Docker CLI, see [Docker CLI E
499
499
Use the **Notifications** tab to turn on or turn off notifications for the following events:
500
500
501
501
-**Status updates on tasks and processes**
502
+
-**Recommendations from Docker**
502
503
-**Docker announcements**
503
504
-**Docker surveys**
504
505
505
-
By default, all notifications are turned on. You'll always receive error notifications and notifications about new Docker Desktop releases and updates.
506
+
By default, all general notifications are turned on. You'll always receive error notifications and notifications about new Docker Desktop releases and updates.
507
+
508
+
You can also [configure notification settings for Docker Scout-related issues](/manuals/scout/explore/dashboard.md#notification-settings).
506
509
507
-
Notifications momentarily appear in the lower-right of the Docker Desktop Dashboard and then move to the **Notifications** drawer. To open the **Notifications** drawer, select {{< inline-image src="../images/notifications.svg" alt="notifications" >}}.
510
+
Notifications momentarily appear in the lower-right of the Docker Desktop Dashboard and then move to the **Notifications** drawer which can be accessed from the top-right of the Docker Desktop Dashboard.
508
511
509
512
## Advanced
510
513
@@ -520,8 +523,8 @@ On Mac, you can reconfigure your initial installation settings on the **Advance
520
523
```
521
524
3. Save and the close the file. Restart your shell to apply the changes to the PATH variable.
522
525
523
-
-**Enable default Docker socket (Requires password)**. Creates `/var/run/docker.sock` which some third party clients may use to communicate with Docker Desktop. For more information, see [permission requirements for macOS](/manuals/desktop/setup/install/mac-permission-requirements.md#installing-symlinks).
526
+
-**Allow the default Docker socket to be used (Requires password)**. Creates `/var/run/docker.sock` which some third party clients may use to communicate with Docker Desktop. For more information, see [permission requirements for macOS](/manuals/desktop/setup/install/mac-permission-requirements.md#installing-symlinks).
524
527
525
-
-**Enable privileged port mapping (Requires password)**. Starts the privileged helper process which binds the ports that are between 1 and 1024. For more information, see [permission requirements for macOS](/manuals/desktop/setup/install/mac-permission-requirements.md#binding-privileged-ports).
528
+
-**Allow privileged port mapping (Requires password)**. Starts the privileged helper process which binds the ports that are between 1 and 1024. For more information, see [permission requirements for macOS](/manuals/desktop/setup/install/mac-permission-requirements.md#binding-privileged-ports).
526
529
527
-
For more information on each configuration and use case, see [Permission requirements](/manuals/desktop/setup/install/mac-permission-requirements.md).
530
+
For more information on each configuration and use case, see [Permission requirements](/manuals/desktop/setup/install/mac-permission-requirements.md).
Copy file name to clipboardExpand all lines: content/manuals/desktop/troubleshoot-and-support/feedback.md
+3-4Lines changed: 3 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ There are many ways you can provide feedback on Docker Desktop or Docker Desktop
12
12
13
13
### In-product feedback
14
14
15
-
On each Docker Desktop Dashboard view, there is a **Give feedback** link. This sends you to a Google feedback form where you can share your feedback and ideas.
15
+
On each Docker Desktop Dashboard view, there is a **Give feedback** link. This opens a feedback form where you can share ideas directly with the Docker team.
16
16
17
17
You can also use the `docker feedback` command to submit feedback directly from the command line.
18
18
@@ -23,8 +23,7 @@ You can also use the `docker feedback` command to submit feedback directly from
23
23
To get help from the community, review current user topics, join or start a
24
24
discussion, sign in to the appropriate Docker forums:
0 commit comments