docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update docs for Desktop 3.0.0 release (#11859) 

* Update docs for Desktop 3.0.0 release

* Update release notes

Signed-off-by: Usha Mandya <usha.mandya@docker.com>

* Update release notes and Settings screenshots

* Add download URLs and a new known issue

Signed-off-by: Usha Mandya <usha.mandya@docker.com>
This commit is contained in:
Usha Mandya 2020-12-10 15:01:02 +00:00 committed by GitHub
parent 872d7dc38a
commit 78421ba741
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
16 changed files with 161 additions and 151 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
_data/toc.yaml
View File

@ -1175,9 +1175,7 @@ manuals:
- path: /docker-for-mac/faqs/
title: FAQs
- path: /docker-for-mac/release-notes/
title: Stable release notes
- path: /docker-for-mac/edge-release-notes/
title: Edge release notes
title: Release notes
- sectiontitle: Windows
section:
- path: /docker-for-windows/install/
@ -1195,9 +1193,7 @@ manuals:
- path: /docker-for-windows/faqs/
title: FAQs
- path: /docker-for-windows/release-notes/
title: Stable release notes
- path: /docker-for-windows/edge-release-notes/
title: Edge release notes
title: Release notes
- path: /docker-for-windows/wsl/
title: Docker Desktop WSL 2 backend
- path: /desktop/dashboard/

12
_layouts/landing.html
View File

@ -209,23 +209,11 @@
What are the system requirements for Docker Desktop?
</a>
</p>
<p class="only-win">
<a href="/docker-for-windows/faqs/#what-is-the-difference-between-the-stable-and-edge-versions-of-docker-desktop">
What is the difference between the Stable and Edge versions of
Docker Desktop?
</a>
</p>
<p class="only-win">
<a href="/docker-for-windows/faqs/#how-do-i-connect-from-a-container-to-a-service-on-the-host">
How do I connect from a container to a service?
</a>
</p>
<p class="only-mac">
<a href="/docker-for-mac/faqs/#what-is-the-difference-between-the-stable-and-edge-versions-of-docker-desktop">
What is the difference between the Stable and Edge versions of
Docker Desktop?
</a>
</p>
<p class="only-mac">
<a href="/docker-for-mac/install/#system-requirements">
What are the system requirements for Docker Desktop?

19
desktop/index.md
View File

@ -36,22 +36,9 @@ To learn about the various UI options and their usage, see:
* [Docker Desktop for Mac user manual](../docker-for-mac/index.md)
* [Docker Desktop for Windows user manual](../docker-for-windows/index.md)
## Stable and Edge versions
Docker Desktop offers Stable and Edge download channels.
The Stable release provides a general availability release-ready installer for a fully baked and tested, more reliable app. The Stable version of Docker Desktop includes the latest released version of Docker Engine. The release schedule is synced every three months for major releases, with patch releases to fix minor issues, and to stay up to date with Docker Engine as required. You can choose to opt out of the usage statistics and telemetry data on the Stable channel.
Docker Desktop Edge release is our preview version. It offers an installer with the latest features and comes with the experimental features turned on. When using the Edge release, bugs, crashes, and issues can occur as the new features may not be fully tested. However, you get a chance to preview new functionality, experiment, and provide feedback as Docker Desktop evolves. Edge releases are typically more frequent than Stable releases. Telemetry data and usage statistics are sent by default on the Edge version.
## Release notes
For information about new features, improvements, and bug fixes in Docker Desktop Stable releases, see:
For information about new features, improvements, and bug fixes in Docker Desktop releases, see:
* [Docker Desktop for Mac Stable Release notes](../docker-for-mac/release-notes.md)
* [Docker Desktop for Windows Stable Release notes](../docker-for-windows/release-notes.md)
For information about new features, improvements, and bug fixes in Docker Desktop Edge releases, see:
* [Docker Desktop for Mac Edge Release notes](../docker-for-mac/edge-release-notes.md)
* [Docker Desktop for Windows Edge Release notes](../docker-for-windows/edge-release-notes.md)
* [Docker Desktop for Mac Release notes](../docker-for-mac/release-notes.md)
* [Docker Desktop for Windows Release notes](../docker-for-windows/release-notes.md)

29
docker-for-mac/faqs.md
View File

@ -6,28 +6,33 @@ redirect_from:
title: Frequently asked questions (FAQ)
---
## Stable and Edge releases
## Docker Desktop releases
### How do I get the Stable or the Edge version of Docker Desktop?
### When will Docker Desktop move to a cumulative release stream?
You can download the Stable or the Edge version of Docker Desktop from [Docker Hub](https://hub.docker.com/editions/community/docker-ce-desktop-mac/).
Starting with version 3.0.0, Docker Desktop will be available as a single, cumulative release stream. This is the same version for both Stable and Edge users. The next release after Docker Desktop 3.0.0 will be the first to be applied as a delta update. For more information, see [Automatic updates](install.md#automatic-updates).
For installation instructions, see [Install Docker Desktop on Mac](install.md){: target="_blank" rel="noopener" class="_"}.
### How do new users install Docker Desktop?
### What is the difference between the Stable and Edge versions of Docker Desktop?
Each Docker Desktop release will also be delivered as a full installer for new users. The same will apply if you have skipped a version, although this will not normally happen as updates will be applied automatically.
Two different download channels are available in the Community version of Docker Desktop:
### How frequent will new releases be?
The **Stable channel** provides a general availability release-ready installer for a fully baked and tested, more reliable app. The Stable version of Docker Desktop comes with the latest released version of Docker Engine. The release
schedule is synched with Docker Engine releases and patch releases. On the Stable channel, you can select whether to send usage statistics and other data.
New releases will be available roughly monthly, similar to Edge today, unless there are critical fixes that need to be released sooner.
The **Edge channel** provides an installer with new features we are working on, but is not necessarily fully tested. It comes with the experimental version of Docker Engine. Bugs, crashes, and issues are more likely to occur with the Edge version, but you get a chance to preview new functionality, experiment, and provide feedback as the apps evolve. Releases are typically more frequent than for Stable, often one or more per month. Usage statistics and crash reports are sent by default. You do not have the option to disable this on the Edge channel.
### How do I ensure that all users on my team are using the same version?
### Can I switch between Stable and Edge versions of Docker Desktop?
Previously you had to manage this yourself: now it will happen automatically as a side effect of all users being on the latest version.
Yes, you can switch between Stable and Edge versions. You can try out the Edge releases to see what's new, then go back to Stable for other work. However, **you can only have one version of Docker Desktop installed at a time**. For more information, see [Switch between Stable and Edge versions](install.md#switch-between-stable-and-edge-versions).
### My colleague has got a new version but I haven’t got it yet.
### What is Docker.app?
Sometimes we may roll out a new version gradually over a few days. Therefore, if you wait, it will turn up soon. Alternatively, you can select **Check for Updates** from the Docker menu to jump the queue and get the latest version immediately.
### Where can I find information about Stable and Edge releases?
Starting with Docker Desktop 3.0.0, Stable and Edge releases are combined into a single, cumulative release stream for all users.
## What is Docker.app?
`Docker.app` is Docker Desktop on Mac. It bundles the Docker client and Docker Engine. `Docker.app` uses the macOS Hypervisor.framework to run containers, which means that a separate VirtualBox is not required to run Docker Desktop.

BIN
docker-for-mac/images/menu/prefs-general.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 72 KiB

After

Width:  |  Height:  |  Size: 104 KiB

10
docker-for-mac/index.md
View File

@ -25,10 +25,6 @@ Welcome to Docker Desktop! The Docker Desktop for Mac user manual provides infor
For information about Docker Desktop download, system requirements, and installation instructions, see [Install Docker Desktop](install.md).
>**Note**
>
> This page contains information about the Docker Desktop Stable release. For information about features available in Edge releases, see the [Edge release notes](edge-release-notes/).
## Preferences
The Docker **Preferences** menu allows you to configure your Docker settings such as installation, updates, version channels, Docker Hub login,
@ -47,16 +43,12 @@ On the **General** tab, you can configure when to start and update Docker:
- **Start Docker Desktop when you log in**: Automatically starts Docker Desktop when you open your session.
- **Automatically check for updates**: By default, Docker Desktop automatically checks for updates and notifies you when an update is available. You can manually check for updates anytime by choosing **Check for Updates** from the main Docker menu.
- **Include VM in Time Machine backups**: Select this option to back up the Docker Desktop virtual machine. This option is disabled by default.
- **Securely store Docker logins in macOS keychain**: Docker Desktop stores your Docker login credentials in macOS keychain by default.
- **Send usage statistics**: Docker Desktop sends diagnostics, crash reports, and usage data. This information helps Docker improve and troubleshoot the application. Clear the check box to opt out.
Click **Switch to the Edge version** to learn more about Docker Desktop Edge releases.
### Resources
The **Resources** tab allows you to configure CPU, memory, disk, proxies, network, and other resources.
@ -163,7 +155,7 @@ On the Command Line page, you can specify whether or not to enable experimental
{% include experimental.md %}
On both Docker Desktop Edge and Stable releases, you can toggle the experimental features on and off. If you toggle the experimental features off, Docker Desktop uses the current generally available release of Docker Engine.
You can toggle the experimental features on and off in Docker Desktop. If you toggle the experimental features off, Docker Desktop uses the current generally available release of Docker Engine.
You can see whether you are running experimental mode at the command line. If
`Experimental` is `true`, then Docker is running in experimental mode, as shown

26
docker-for-mac/install.md
View File

@ -73,6 +73,12 @@ Congratulations! You are now successfully running Docker Desktop.
If you would like to rerun the tutorial, go to the Docker Desktop menu
and select **Learn**.
## Automatic updates
Starting with Docker Desktop 3.0.0, updates to Docker Desktop will be available automatically as delta updates from the previous version.
When an update is available, Docker Desktop automatically downloads it to your machine and displays an icon to indicate the availability of a newer version. All you need to do now is to click **Update and restart** from the Docker menu. This installs the latest update and restarts Docker Desktop for the changes to take effect.
## Uninstall Docker Desktop
To unistall Docker Desktop from your Mac:
@ -82,23 +88,9 @@ To unistall Docker Desktop from your Mac:
> **Note:** Uninstalling Docker Desktop will destroy Docker containers and images local to the machine and remove the files generated by the application.
## Switch between Stable and Edge versions
Docker Desktop allows you to switch between Stable and Edge releases. However, **you can only have one version of Docker Desktop installed at a time**. Switching between Stable and Edge versions can destabilize your development environment, particularly in cases where you switch from a newer (Edge) channel to an older (Stable) channel.
For example, containers created with a newer Edge version of Docker Desktop may
not work after you switch back to Stable because they may have been created
using Edge features that aren't in Stable yet. Keep this in mind as
you create and work with Edge containers, perhaps in the spirit of a playground
space where you are prepared to troubleshoot or start over.
Experimental features are turned on by default on Edge releases. However, when you switch from a Stable to an Edge release, you must turn on the experimental features flag to access experimental features. From the Docker Desktop menu, click **Preferences** > **Command Line** and then turn on the **Enable experimental features** toggle. Click **Apply & Restart** for the changes to take effect.
To safely switch between Edge and Stable versions, ensure you save images and export the containers you need, then uninstall the current version before installing another. For more information, see the section **Save and Restore data** below.
### Save and restore data
You can use the following procedure to save and restore images and container data. For example, if you want to switch between Edge and Stable, or to reset your VM disk:
You can use the following procedure to save and restore images and container data. For example to reset your VM disk:
1. Use `docker save -o images.tar image1 [image2 ...]` to save any images you
want to keep. See [save](/engine/reference/commandline/save) in the Docker
@ -125,7 +117,5 @@ For information on how to back up and restore data volumes, see [Backup, restore
- [Troubleshooting](troubleshoot.md) describes common problems, workarounds, how
to run and submit diagnostics, and submit issues.
- [FAQs](faqs.md) provide answers to frequently asked questions.
- [Release notes](release-notes.md) lists component updates, new features, and
improvements associated with Stable releases. For information about Edge releases, see
[Edge release notes](edge-release-notes.md).
- [Release notes](release-notes.md) lists component updates, new features, and improvements associated with Docker Desktop releases.
- [Get started with Docker](/get-started/) provides a general Docker tutorial.

55
docker-for-mac/release-notes.md
View File

@ -1,17 +1,60 @@
---
description: Change log / release notes per Stable release
keywords: Docker Desktop for Mac, stable, release notes
description: Change log / release notes for Docker Desktop Mac
keywords: Docker Desktop for Mac, release notes
redirect_from:
- /mackit/release-notes/
title: Docker for Mac Stable release notes
- /docker-for-mac/edge-release-notes/
title: Docker for Mac release notes
toc_min: 1
toc_max: 2
---
This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop Stable releases.
This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop releases.
For information about Edge releases, see the [Edge release notes](edge-release-notes.md). For Docker Desktop system requirements, see
[What to know before you install](install.md#what-to-know-before-you-install).
> **Important**
>
> Starting with Docker Desktop 3.0.0, Stable and Edge releases are combined into a single release stream for all users. Updates to Docker Desktop will now be available automatically as delta updates from the previous version. This means, when there is a newer version of Docker Desktop, it will be automatically downloaded to your machine. All you need to do is to click **Update and restart** from the Docker menu to install the latest update.
{: .important }
## Docker Desktop Community 3.0.0
2020-12-10
> [Download](https://desktop.docker.com/mac/stable/50684/Docker.dmg)
### New
- Use of three-digit version number for Docker Desktop releases.
- Starting with Docker Desktop 3.0.0, updates are now much smaller as they will be applied using delta patches. For more information, see [Automatic updates](install.md#automatic-updates).
- First version of `docker compose` (as an alternative to the existing `docker-compose`). Supports some basic commands but not the complete functionality of `docker-compose` yet.
- Supports the following subcommands: `up`, `down`, `logs`, `build`, `pull`, `push`, `ls`, `ps`
- Supports basic volumes, bind mounts, networks, and environment variables
Let us know your feedback by creating an issue in the [compose-cli](https://github.com/docker/compose-cli/issues){: target="blank" rel="noopener" class=“”} GitHub repository.
- [Docker Hub Tool v0.2.0](https://github.com/docker/roadmap/issues/117){: target="blank" rel="noopener" class=“”}
### Upgrades
- [Docker Engine 20.10.0](https://docs.docker.com/engine/release-notes/#20100)
- [Go 1.15.6](https://github.com/golang/go/issues?q=milestone%3AGo1.15.6+label%3ACherryPickApproved+)
- [Compose CLI v1.0.4](https://github.com/docker/compose-cli/releases/tag/v1.0.4)
- [Snyk v1.432.0](https://github.com/snyk/snyk/releases/tag/v1.432.0)
### Bug fixes and minor changes
- Downgraded the kernel to [4.19.121](https://hub.docker.com/layers/docker/for-desktop-kernel/4.19.121-2a1dbedf3f998dac347c499808d7c7e029fbc4d3-amd64/images/sha256-4e7d94522be4f25f1fbb626d5a0142cbb6e785f37e437f6fd4285e64a199883a?context=repo) to reduce the CPU usage of hyperkit. Fixes [docker/for-mac#5044](https://github.com/docker/for-mac/issues/5044)
- Fixed a bug that DNS would return `NXDOMAIN` when a name exists but the type of record was not found. Fixes [docker/for-mac#5020](https://github.com/docker/for-mac/issues/5020). Related to https://gitlab.alpinelinux.org/alpine/aports/-/issues/11879
- Avoid caching bad file sizes and modes when using `osxfs`. Fixes [docker/for-mac#5045](https://github.com/docker/for-mac/issues/5045).
- Fixed a possible file sharing error where a file may appear to have the wrong size in a container when it is modified on the host. This is a partial fix for [docker/for-mac#4999](https://github.com/docker/for-mac/issues/4999).
- Removed unnecessary log messages which slow down filesystem event injection.
- Re-enabled the experimental SOCKS proxy. Fixes [docker/for-mac#5048](https://github.com/docker/for-mac/issues/5048).
- Fixed an unexpected EOF error when trying to start a non-existing container with `-v /var/run/docker.sock:`. See [docker/for-mac#5025](https://github.com/docker/for-mac/issues/5025).
- Display an error message instead of crashing when the application needs write access on specific directories. See [docker/for-mac#5068](https://github.com/docker/for-mac/issues/5068)
### Known issues
- Building an image with BuildKit from a git URL fails when using the form `github.com/org/repo`. To work around this issue, use the form `git://github.com/org/repo`.
- Some DNS addresses fail to resolve within containers based on Alpine Linux 3.13.
## Docker Desktop Community 2.5.0.1
2020-11-10

30
docker-for-windows/faqs.md
View File

@ -4,29 +4,31 @@ keywords: windows faqs
title: Frequently asked questions (FAQ)
---
## Stable and Edge releases
## Docker Desktop releases
### How do I get the Stable or the Edge version of Docker Desktop?
### When will Docker Desktop move to a cumulative release stream?
You can download the Stable or the Edge version of Docker Desktop from [Docker Hub](https://hub.docker.com/editions/community/docker-ce-desktop-windows/).
Starting with version 3.0.0, Docker Desktop will be available as a single, cumulative release stream. This is the same version for both Stable and Edge users. The next release after Docker Desktop 3.0.0 will be the first to be applied as a delta update. For more information, see [Automatic updates](install.md#automatic-updates).
For installation instructions, see [Install Docker Desktop on Windows](install.md){: target="_blank" rel="noopener" class="_"}.
### How do new users install Docker Desktop?
### What is the difference between the Stable and Edge versions of Docker Desktop?
Each Docker Desktop release will also be delivered as a full installer for new users. The same will apply if you have skipped a version, although this will not normally happen as updates will be applied automatically.
Two different download channels are available in the Community version of Docker Desktop:
### How frequent will new releases be?
The **Stable channel** provides a general availability release-ready installer
for a fully baked and tested, more reliable app. The Stable version of Docker
Desktop includes the latest released version of Docker Engine. The
release schedule is synced with Docker Engine releases and patch releases. On the Stable channel, you can select whether to send usage statistics and other data.
New releases will be available roughly monthly, similar to Edge today, unless there are critical fixes that need to be released sooner.
The **Edge channel** provides an installer with new features we are working on, but is not necessarily fully tested. It includes the experimental version of
Docker Engine. Bugs, crashes, and issues can occur when using the Edge version, but you get a chance to preview new functionality, experiment, and provide feedback as Docker Desktop evolves. Edge releases are typically more frequent than for Stable, often one or more per month. Usage statistics and crash reports are sent by default. You do not have the option to disable this on the Edge channel.
### How do I ensure that all users on my team are using the same version?
### Can I switch between Stable and Edge versions of Docker Desktop?
Previously you had to manage this yourself: now it will happen automatically as a side effect of all users being on the latest version.
Yes, you can switch between Stable and Edge versions. You can try out the Edge releases to see what's new, then go back to Stable for other work. However, **you can only have one version of Docker Desktop installed at a time**. For more information, see [Switch between Stable and Edge versions](install.md#switch-between-stable-and-edge-versions).
### My colleague has got a new version but I haven’t got it yet.
Sometimes we may roll out a new version gradually over a few days. Therefore, if you wait, it will turn up soon. Alternatively, you can select **Check for Updates** from the Docker menu to jump the queue and get the latest version immediately.
### Where can I find information about Stable and Edge releases?
Starting with Docker Desktop 3.0.0, Stable and Edge releases are combined into a single, cumulative release stream for all users.
## What are the system requirements for Docker Desktop?

BIN
docker-for-windows/images/docker-menu-settings.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 15 KiB

BIN
docker-for-windows/images/settings-general.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 107 KiB

After

Width:  |  Height:  |  Size: 109 KiB

18
docker-for-windows/index.md
View File

@ -20,10 +20,6 @@ Welcome to Docker Desktop! The Docker Desktop for Windows user manual provides i
For information about Docker Desktop download, system requirements, and installation instructions, see [Install Docker Desktop](install.md).
>**Note**
>
> This page contains information about the Docker Desktop Stable release. For information about features available in Edge releases, see the [Edge release notes](edge-release-notes.md).
## Settings
The **Docker Desktop** menu allows you to configure your Docker settings such as installation, updates, version channels, Docker Hub login,
@ -47,19 +43,12 @@ On the **General** tab of the Settings dialog, you can configure when to start a
* **Start Docker when you log in** - Automatically start Docker Desktop upon Windows system login.
* **Automatically check for updates** - By default, Docker Desktop automatically checks for updates and notifies you when an update is available.
Click **OK** to accept and install updates (or cancel to keep the current
version). You can manually update by choosing **Check for Updates** from the
main Docker menu.
* **Expose daemon on tcp://localhost:2375 without TLS** - Click this option to enable legacy clients to connect to the Docker daemon. You must use this option with caution as exposing the daemon without TLS can result in remote code execution attacks.
* **Send usage statistics** - By default, Docker Desktop sends diagnostics,
crash reports, and usage data. This information helps Docker improve and
troubleshoot the application. Clear the check box to opt out. Docker may periodically prompt you for more information.
Click **Switch to the Edge version** to learn more about Docker Desktop Edge releases.
### Resources
The **Resources** tab allows you to configure CPU, memory, disk, proxies,
@ -176,7 +165,7 @@ You can configure Docker Desktop networking to work on a virtual private network
> **Note**
>
> Some users reported problems connecting to Docker Hub on Docker Desktop Stable version. This would manifest as an error when trying to run
> Some users reported problems connecting to Docker Hub on Docker Desktop. This would manifest as an error when trying to run
`docker` commands that pull images from Docker Hub that are not already
downloaded, such as a first time run of `docker run hello-world`. If you
encounter this, reset the DNS server to use the Google DNS fixed address:
@ -214,13 +203,10 @@ Click **Apply & Restart** to save your settings and restart Docker Desktop.
On the Command Line page, you can specify whether or not to enable experimental features.
On both Docker Desktop Edge and Stable releases, you can toggle the experimental features on and off. If you toggle the experimental features off, Docker Desktop uses the current generally available release of Docker Engine.
You can toggle the experimental features on and off in Docker Desktop. If you toggle the experimental features off, Docker Desktop uses the current generally available release of Docker Engine.
#### Experimental features
Docker Desktop Edge releases have the experimental version
of Docker Engine enabled by default, described in the [Docker Experimental Features README](https://github.com/docker/cli/blob/master/experimental/README.md) on GitHub.
{% include experimental.md %}
Run `docker version` to verify whether you have enabled experimental features. Experimental mode

24
docker-for-windows/install-windows-home.md
View File

@ -95,6 +95,12 @@ When the initialization is complete, Docker Desktop launches the onboarding tuto
Congratulations! You are now successfully running Docker Desktop on Windows Home.
## Automatic updates
Starting with Docker Desktop 3.0.0, updates to Docker Desktop will be available automatically as delta updates from the previous version.
When an update is available, Docker Desktop automatically downloads it to your machine and displays an icon to indicate the availability of a newer version. All you need to do now is to click **Update and restart** from the Docker menu. This installs the latest update and restarts Docker Desktop for the changes to take effect.
## Uninstall Docker Desktop
To uninstall Docker Desktop from your Windows Home machine:
@ -107,21 +113,9 @@ To uninstall Docker Desktop from your Windows Home machine:
>
> Uninstalling Docker Desktop will destroy Docker containers and images local to the machine and remove the files generated by the application.
## Switch between Stable and Edge versions
Docker Desktop allows you to switch between Stable and Edge releases. However, **you can only have one version of Docker Desktop installed at a time**. Switching between Stable and Edge versions can destabilize your development environment, particularly in cases where you switch from a newer (Edge) channel to an older (Stable) channel.
For example, containers created with a newer Edge version of Docker Desktop may
not work after you switch back to Stable because they may have been created
using Edge features that aren't in Stable yet. Keep this in mind as
you create and work with Edge containers, perhaps in the spirit of a playground
space where you are prepared to troubleshoot or start over.
To safely switch between Edge and Stable versions, ensure you save images and export the containers you need, then uninstall the current version before installing another. For more information, see the section _Save and Restore data_ below.
### Save and restore data
You can use the following procedure to save and restore images and container data. For example, if you want to switch between Edge and Stable, or to reset your VM disk:
You can use the following procedure to save and restore images and container data. For example, to reset your VM disk:
1. Use `docker save -o images.tar image1 [image2 ...]` to save any images you
want to keep. See [save](../engine/reference/commandline/save.md) in the Docker
@ -131,7 +125,7 @@ You can use the following procedure to save and restore images and container dat
want to keep. See [export](../engine/reference/commandline/export.md) in the
Docker Engine command line reference.
3. Uninstall the current version of Docker Desktop and install a different version (Stable or Edge), or reset your VM disk.
3. Uninstall the current version of Docker Desktop and install a different version, or reset your VM disk.
4. Use `docker load -i images.tar` to reload previously saved images. See
[load](../engine/reference/commandline/load.md) in the Docker Engine.
@ -150,4 +144,4 @@ For information on how to back up and restore data volumes, see [Backup, restore
* [Troubleshooting](troubleshoot.md) describes common problems, workarounds, and
how to get support.
* [FAQs](faqs.md) provides answers to frequently asked questions.
* [Stable Release Notes](release-notes.md) or [Edge Release Notes](edge-release-notes.md).
* [Release notes](release-notes.md) lists component updates, new features, and improvements associated with Docker Desktop releases.

26
docker-for-windows/install.md
View File

@ -104,6 +104,12 @@ Congratulations! You are now successfully running Docker Desktop on Windows.
If you would like to rerun the tutorial, go to the Docker Desktop menu
and select **Learn**.
## Automatic updates
Starting with Docker Desktop 3.0.0, updates to Docker Desktop will be available automatically as delta updates from the previous version.
When an update is available, Docker Desktop automatically downloads it to your machine and displays an icon to indicate the availability of a newer version. All you need to do now is to click **Update and restart** from the Docker menu. This installs the latest update and restarts Docker Desktop for the changes to take effect.
## Uninstall Docker Desktop
To uninstall Docker Desktop from your Windows machine:
@ -114,23 +120,9 @@ To uninstall Docker Desktop from your Windows machine:
> **Note:** Uninstalling Docker Desktop will destroy Docker containers and images local to the machine and remove the files generated by the application.
## Switch between Stable and Edge versions
Docker Desktop allows you to switch between Stable and Edge releases. However, **you can only have one version of Docker Desktop installed at a time**. Switching between Stable and Edge versions can destabilize your development environment, particularly in cases where you switch from a newer (Edge) channel to an older (Stable) channel.
For example, containers created with a newer Edge version of Docker Desktop may
not work after you switch back to Stable because they may have been created
using Edge features that aren't in Stable yet. Keep this in mind as
you create and work with Edge containers, perhaps in the spirit of a playground
space where you are prepared to troubleshoot or start over.
Experimental features are turned on by default on Edge releases. However, when you switch from a Stable to an Edge release, you must turn on the experimental features flag to access experimental features. From the Docker Desktop menu, click **Settings** > **Command Line** and then turn on the **Enable experimental features** toggle. Click **Apply & Restart** for the changes to take effect.
To safely switch between Edge and Stable versions, ensure you save images and export the containers you need, then uninstall the current version before installing another. For more information, see the section _Save and Restore data_ below.
### Save and restore data
You can use the following procedure to save and restore images and container data. For example, if you want to switch between Edge and Stable, or to reset your VM disk:
You can use the following procedure to save and restore images and container data. For example, if you want to reset your VM disk:
1. Use `docker save -o images.tar image1 [image2 ...]` to save any images you
want to keep. See [save](/engine/reference/commandline/save) in the Docker
@ -140,7 +132,7 @@ You can use the following procedure to save and restore images and container dat
want to keep. See [export](/engine/reference/commandline/export) in the
Docker Engine command line reference.
3. Uninstall the current version of Docker Desktop and install a different version (Stable or Edge), or reset your VM disk.
3. Uninstall the current version of Docker Desktop and install a different version, or reset your VM disk.
4. Use `docker load -i images.tar` to reload previously saved images. See
[load](/engine/reference/commandline/load) in the Docker Engine.
@ -159,4 +151,4 @@ For information on how to back up and restore data volumes, see [Backup, restore
* [Troubleshooting](troubleshoot.md) describes common problems, workarounds, and
how to get support.
* [FAQs](faqs.md) provides answers to frequently asked questions.
* [Stable Release Notes](release-notes.md) or [Edge Release Notes](edge-release-notes.md).
* [Release notes](release-notes.md) lists component updates, new features, and improvements associated with Docker Desktop releases.

49
docker-for-windows/release-notes.md
View File

@ -1,17 +1,54 @@
---
description: Change log / release notes per stable release
keywords: Docker Desktop for Windows, stable, release notes
description: Docker Desktop for Windows Release notes
keywords: Docker Desktop for Windows, release notes
redirect_from:
- /winkit/release-notes/
title: Docker Desktop for Windows Stable Release notes
- /docker-for-windows/edge-release-notes/
title: Docker for Windows release notes
toc_min: 1
toc_max: 2
---
This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop Stable releases.
This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop releases.
For information about Edge releases, see the [Edge release notes](edge-release-notes.md). For Docker Desktop system requirements, see
[What to know before you install](install.md#what-to-know-before-you-install).
> **Important**
>
> Starting with Docker Desktop 3.0.0, Stable and Edge releases are combined into a single release stream for all users. Updates to Docker Desktop will now be available automatically as delta updates from the previous version. This means, when there is a newer version of Docker Desktop, it will be automatically downloaded to your machine. All you need to do is to click **Update and restart** from the Docker menu to install the latest update.
{: .important }
## Docker Desktop Community 3.0.0
2020-12-10
> [Download](https://desktop.docker.com/win/stable/50684/Docker%20Desktop%20Installer.exe)
### New
- Use of three-digit version number for Docker Desktop releases.
- Docker Desktop updates are now much smaller as they will be applied using delta patches. For more information, see [Automatic updates](install.md#automatic-updates).
- First version of `docker compose` (as an alternative to the existing `docker-compose`). Supports some basic commands but not the complete functionality of `docker-compose` yet.
- Supports the following subcommands: `up`, `down`, `logs`, `build`, `pull`, `push`, `ls`, `ps`
- Supports basic volumes, bind mounts, networks, and environment variables
Let us know your feedback by creating an issue in the [compose-cli](https://github.com/docker/compose-cli/issues){: target="blank" rel="noopener" class=“”} GitHub repository.
- [Docker Hub Tool v0.2.0](https://github.com/docker/roadmap/issues/117){: target="blank" rel="noopener" class=“”}
### Upgrades
- [Docker Engine 20.10.0](https://docs.docker.com/engine/release-notes/#20100)
- [Go 1.15.6](https://github.com/golang/go/issues?q=milestone%3AGo1.15.6+label%3ACherryPickApproved+)
- [Compose CLI v1.0.4](https://github.com/docker/compose-cli/releases/tag/v1.0.4)
- [Snyk v1.432.0](https://github.com/snyk/snyk/releases/tag/v1.432.0)
### Bug fixes and minor changes
- Downgraded the kernel to [4.19.121](https://hub.docker.com/layers/docker/for-desktop-kernel/4.19.121-2a1dbedf3f998dac347c499808d7c7e029fbc4d3-amd64/images/sha256-4e7d94522be4f25f1fbb626d5a0142cbb6e785f37e437f6fd4285e64a199883a?context=repo) to reduce the CPU usage of hyperkit. Fixes [docker/for-mac#5044](https://github.com/docker/for-mac/issues/5044)
- Fixed an unexpected EOF error when trying to start a non-existing container with `-v /var/run/docker.sock:`. See [docker/for-mac#5025](https://github.com/docker/for-mac/issues/5025).
### Known issues
- Building an image with BuildKit from a git URL fails when using the form `github.com/org/repo`. To work around this issue, use the form `git://github.com/org/repo`.
- Some DNS addresses fail to resolve within containers based on Alpine Linux 3.13.
## Docker Desktop Community 2.5.0.1
2020-11-10

6
release-notes/index.md
View File

@ -10,9 +10,7 @@ find release notes for each component in the product manuals section. We suggest
that you regularly visit the release notes to learn about updates.
- [Docker Engine](/engine/release-notes/)
- [Docker Desktop for Mac (Stable)](/docker-for-mac/release-notes/)
- [Docker Desktop for Mac (Edge)](/docker-for-mac/edge-release-notes/)
- [Docker Desktop for Windows (Stable)](/docker-for-windows/release-notes/)
- [Docker Desktop for Windows (Edge)](/docker-for-windows/edge-release-notes/)
- [Docker Desktop for Mac](/docker-for-mac/release-notes/)
- [Docker Desktop for Windows](/docker-for-windows/release-notes/)
- [Docker Hub](/docker-hub/release-notes/)
- [Docker Compose](/compose/release-notes/)