diff --git a/_data/toc.yaml b/_data/toc.yaml index f429054e5e..f4f749bb28 100644 --- a/_data/toc.yaml +++ b/_data/toc.yaml @@ -1167,6 +1167,8 @@ manuals: title: Explore Images - path: /desktop/use-desktop/volumes/ title: Explore Volumes + - path: /desktop/use-desktop/pause/ + title: Pause Docker Desktop - sectiontitle: Change settings section: - path: /desktop/settings/mac/ diff --git a/desktop/get-started.md b/desktop/get-started.md index 224a428ec2..04ec220743 100644 --- a/desktop/get-started.md +++ b/desktop/get-started.md @@ -112,17 +112,3 @@ Digest: sha256:3c6b73ce467f04d4897d7a7439782721fd28ec9bf62ea2ad9e81a5fb7fb3ff96 Status: Downloaded newer image for molly/privateimage:latest docker.io/molly/privateimage:latest ``` - -## Pause or resume Docker Desktop - -You can pause your Docker Desktop session when you are not actively using it and save CPU resources on your machine. When you pause Docker Desktop, the Linux VM running Docker Engine is paused, the current state of all your containers are saved in memory, and all processes are frozen. This reduces the CPU usage and helps you retain a longer battery life on your laptop. You can resume Docker Desktop when you want by clicking the **Resume** option. - -From the Docker menu, select![whale menu](images/whale-x.png){: .inline} and then **Pause** to pause Docker Desktop. - -Docker Desktop displays the paused status on the Docker menu and on the **Containers**, **Images**, **Volumes**, and **Dev Environment** screens in Docker Dashboard. You can still access the **Preferences** (or **Settings** if you are a Windows user) and the **Troubleshoot** menu from the Dashboard when you've paused Docker Desktop. - -Select ![whale menu](images/whale-x.png){: .inline} then **Resume** to resume Docker Desktop. - -> **Note** -> -> When Docker Desktop is paused, running any commands in the Docker CLI will automatically resume Docker Desktop. \ No newline at end of file diff --git a/desktop/index.md b/desktop/index.md index 143b519b52..f597943f4a 100644 --- a/desktop/index.md +++ b/desktop/index.md @@ -1,7 +1,7 @@ --- description: Docker Desktop overview keywords: Desktop, Docker, GUI, run, docker, local, machine, dashboard -title: Docker Desktop overview +title: Docker Desktop redirect_from: - /desktop/opensource/ - /docker-for-mac/opensource/ @@ -28,7 +28,7 @@ Docker Desktop includes: - [Docker Compose](../compose/index.md) - [Docker Content Trust](../engine/security/trust/index.md) - [Kubernetes](https://github.com/kubernetes/kubernetes/) -- [Credential Helper](https://github.com/docker/docker-credential-helpers/). +- [Credential Helper](https://github.com/docker/docker-credential-helpers/) Docker Desktop works with your choice of development tools and languages and gives you access to a vast library of certified images and templates in @@ -44,7 +44,7 @@ When you open Docker Desktop, the Docker Dashboard displays. The **Containers** view provides a runtime view of all your containers and applications. It allows you to interact with containers and applications, and manage the lifecycle of your applications directly from your machine. This view also provides an intuitive interface to perform common actions to inspect, interact with, and manage your Docker objects including containers and Docker Compose-based applications. For more information, see [Explore running containers and applications](use-desktop/container.md). -The **Images** view displays a list of your Docker images and allows you to run an image as a container, pull the latest version of an image from Docker Hub, and inspect images. It also displays a summary of the vulnerability scanning report using Snyk. In addition, the **Images** view contains clean-up options to remove unwanted images from the disk to reclaim space. If you are logged in, you can also see the images you and your organization have shared on Docker Hub. For more information, see [Explore your images](use-desktop/images.md) +The **Images** view displays a list of your Docker images and allows you to run an image as a container, pull the latest version of an image from Docker Hub, and inspect images. It also displays a summary of the vulnerability scanning report using Snyk. In addition, the **Images** view contains clean-up options to remove unwanted images from the disk to reclaim space. If you are logged in, you can also see the images you and your organization have shared on Docker Hub. For more information, see [Explore your images](use-desktop/images.md). The **Volumes** view displays a list of volumes and allows you to easily create and delete volumes and see which ones are being used. For more information, see [Explore volumes](use-desktop/volumes.md). diff --git a/desktop/troubleshoot/known-issues.md b/desktop/troubleshoot/known-issues.md index eced8f2e6b..c21e0ded6d 100644 --- a/desktop/troubleshoot/known-issues.md +++ b/desktop/troubleshoot/known-issues.md @@ -3,8 +3,6 @@ description: Known issues for Mac keywords: mac, troubleshooting, known issues title: Known issues for Docker Desktop on Mac --- -## Known issues - * The following issues are seen when using the `virtualization.framework` experimental feature: * Some VPN clients can prevent the VM running Docker from communicating with the host, preventing Docker Desktop starting correctly. See [docker/for-mac#5208](https://github.com/docker/for-mac/issues/5208). diff --git a/desktop/troubleshoot/overview.md b/desktop/troubleshoot/overview.md index e4f828c037..beb023cc12 100644 --- a/desktop/troubleshoot/overview.md +++ b/desktop/troubleshoot/overview.md @@ -215,7 +215,7 @@ $ /usr/bin/log show --debug --info --style syslog --last 1d --predicate "$pred" ### In the Console app -Mac provides a built-in log viewer, named "Console", which you can use to check +Mac provides a built-in log viewer, named **Console**, which you can use to check Docker logs. The Console lives in `/Applications/Utilities`. You can search for it with @@ -254,7 +254,11 @@ to learn how to view the Docker Daemon logs. - +## What's next? + +- View [Troubleshoot topics](topics.md). +- Implement [workarounds for common problems](workarounds.md) +- If you're a Mac user, see [Known issues for Mac](known-issues.md) diff --git a/desktop/use-desktop/container.md b/desktop/use-desktop/container.md index ccf9874aef..41d62476bb 100644 --- a/desktop/use-desktop/container.md +++ b/desktop/use-desktop/container.md @@ -21,7 +21,7 @@ When you hover over individual containers, you can also: - Click **Open in Visual Studio Code** to open the application in VS Code. - Open the port exposed by the container in a browser. -### Inspect a container +## Inspect a container You can obtain detailed information about the container when you select a container. diff --git a/desktop/use-desktop/pause.md b/desktop/use-desktop/pause.md new file mode 100644 index 0000000000..ebafd41104 --- /dev/null +++ b/desktop/use-desktop/pause.md @@ -0,0 +1,17 @@ +--- +description: Pause Docker Dashboard +keywords: Docker Dashboard, manage, containers, gui, dashboard, images, user manual +title: Pause Docker Desktop +--- + +You can pause your Docker Desktop session when you are not actively using it and save CPU resources on your machine. When you pause Docker Desktop, the Linux VM running Docker Engine is paused, the current state of all your containers are saved in memory, and all processes are frozen. This reduces the CPU usage and helps you retain a longer battery life on your laptop. You can resume Docker Desktop when you want by clicking the **Resume** option. + +From the Docker menu, select![whale menu](../images/whale-x.png){: .inline} and then **Pause** to pause Docker Desktop. + +Docker Desktop displays the paused status on the Docker menu and on the **Containers**, **Images**, **Volumes**, and **Dev Environment** screens in Docker Dashboard. You can still access the **Preferences** (or **Settings** if you are a Windows user) and the **Troubleshoot** menu from the Dashboard when you've paused Docker Desktop. + +Select ![whale menu](../images/whale-x.png){: .inline} then **Resume** to resume Docker Desktop. + +> **Note** +> +> When Docker Desktop is paused, running any commands in the Docker CLI will automatically resume Docker Desktop. diff --git a/desktop/use-desktop/volumes.md b/desktop/use-desktop/volumes.md index d708f466ab..2007f883c9 100644 --- a/desktop/use-desktop/volumes.md +++ b/desktop/use-desktop/volumes.md @@ -31,7 +31,7 @@ The **Data** tab displays the files and folders in the volume and the file size. To delete a file or a folder from the volume, select **Remove** from the **More options** menu. -### Remove a volume +## Remove a volume Removing a volume deletes the volume and all its data.