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

ENGDOCS-1938-tier2 (#19076)

This commit is contained in:
Allie Sadler 2024-01-11 08:18:55 +00:00 committed by GitHub
parent 7a51f6a8ef
commit 418a47c7bc
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
27 changed files with 118 additions and 128 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
content/desktop/_index.md
View File

@ -46,7 +46,7 @@ aliases:
---
Docker Desktop is a one-click-install application for your Mac, Linux, or Windows environment
that lets you to build, share, and run containerized applications and microservices.
that lets you build, share, and run containerized applications and microservices.
It provides a straightforward GUI (Graphical User Interface) that lets you manage your containers, applications, and images directly from your machine. You can use Docker Desktop either on its own or as a complementary tool to the CLI.
@ -59,7 +59,7 @@ Docker Desktop reduces the time spent on complex setups so you can focus on writ
- [Docker Engine](../engine/index.md)
- Docker CLI client
- [Docker Scout](../scout/_index.md) (additional subscription may apply)
- [Docker Buildx](../build/index.md)
- [Docker Build](../build/index.md)
- [Docker Extensions](extensions/index.md)
- [Docker Compose](../compose/index.md)
- [Docker Content Trust](../engine/security/trust/index.md)
@ -72,7 +72,7 @@ Docker Desktop reduces the time spent on complex setups so you can focus on writ
* Ability to containerize and share any application on any cloud platform, in multiple languages and frameworks.
* Quick installation and setup of a complete Docker development environment.
* Includes the latest version of Kubernetes.
* On Windows, the ability to toggle between Linux and Windows Server environments to build applications.
* On Windows, the ability to toggle between Linux and Windows containers to build applications.
* Fast and reliable performance with native Windows Hyper-V virtualization.
* Ability to work natively on Linux through WSL 2 on Windows machines.
* Volume mounting for code and data, including file change notifications and easy access to running containers on the localhost network.

2
content/desktop/dev-environments/_index.md
View File

@ -17,8 +17,6 @@ It uses tools built into code editors that allows Docker to access code mounted
You can use Dev Environments through the intuitive GUI in Docker Dashboard or straight from your terminal with the new [`docker dev` CLI plugin](dev-cli.md).
![Dev environments tab in Docker Desktop](../images/dev-env.PNG)
## How does it work?
>**Changes to Dev Environments with Docker Desktop 4.13**

4
content/desktop/extensions/_index.md
View File

@ -22,7 +22,3 @@ You can explore the list of available extensions in [Docker Hub](https://hub.doc
To find out more about Docker Extensions, we recommend the video walkthrough from DockerCon 2022:
<iframe width="750" height="315" src="https://www.youtube.com/embed/3rAGXS8pszQ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
## Prerequisites
Docker Extensions are available as part of Docker Desktop 4.8.0 and later releases. [Download and install Docker Desktop 4.8.0 or later](../release-notes.md).

8
content/desktop/feedback.md
View File

@ -7,7 +7,7 @@ title: Give feedback
There are many ways you can provide feedback on Docker Desktop or Docker Desktop features.
#### In-product feedback
### In-product feedback
On each Docker 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,7 +15,7 @@ You can also use the `docker feedback` command to submit feedback directly from
<script async id="asciicast-KkC0fFrhV8nAzvXUGqay06UXx" src="https://asciinema.org/a/KkC0fFrhV8nAzvXUGqay06UXx.js"></script>
#### Feedback via Docker Community forums
### Feedback via Docker Community forums
To get help from the community, review current user topics, join or start a
discussion, sign in to the appropriate Docker forums:
@ -25,7 +25,7 @@ forum](https://forums.docker.com/c/docker-for-mac)
- [Docker Desktop for Windows forum](https://forums.docker.com/c/docker-for-windows)
- [Docker Desktop for Linux forum](https://forums.docker.com/c/docker-desktop-for-linux/60)
#### Report bugs or problems on GitHub
### Report bugs or problems on GitHub
To report bugs or problems, visit:
- [Docker Desktop for Mac issues on
@ -36,7 +36,7 @@ GitHub](https://github.com/docker/desktop-linux/issues)
- [Dev Environments issues on Github](https://github.com/docker/dev-environments/issues)
- [Docker Extensions issues on GitHub](https://github.com/docker/extensions-sdk/issues)
#### Feedback via Community Slack channels
### Feedback via Community Slack channels
You can also provide feedback through the following [Docker Community Slack](https://dockr.ly/comm-slack) channels:

14
content/desktop/get-started.md
View File

@ -29,19 +29,23 @@ aliases:
- /winkit/getting-started/
---
Docker recommends that you authenticate using the **Sign in** option in the top-right corner of the Docker Dashboard.
Docker recommends that you authenticate using the **Sign in** option in the top-right corner of the Docker Dashboard.
Once signed in, you can access your Docker Hub repositories directly from Docker Desktop.
In large enterprises where admin access is restricted, administrators can [Configure registry.json to enforce sign-in](../security/for-admins/configure-sign-in.md).
Authenticated users also get a higher pull rate limit compared to anonymous users. For example, if you are authenticated, you get 200 pulls per 6 hour period, compared to 100 pulls per 6 hour period per IP address for anonymous users. For more information, see [Download rate limit](../docker-hub/download-rate-limit.md).
## Benefits of signing in
In large enterprises where admin access is restricted, administrators can [Configure registry.json to enforce sign-in](../security/for-admins/configure-sign-in.md). Enforcing developers to authenticate through Docker Desktop also allows administrators to improve their organization’s security posture for containerized development by taking advantage of [Hardened Desktop](hardened-desktop/index.md).
- You can access your Docker Hub repositories directly from Docker Desktop.
- Authenticated users also get a higher pull rate limit compared to anonymous users. For example, if you are authenticated, you get 200 pulls per 6 hour period, compared to 100 pulls per 6 hour period per IP address for anonymous users. For more information, see [Download rate limit](../docker-hub/download-rate-limit.md).
- Improve your organization’s security posture for containerized development by taking advantage of [Hardened Desktop](hardened-desktop/index.md).
> **Note**
>
> Docker Desktop automatically signs you out after 90 days, or after 30 days of inactivity.
### Signing in with Docker Desktop for Linux
## Signing in with Docker Desktop for Linux
Docker Desktop for Linux relies on [`pass`](https://www.passwordstore.org/) to store credentials in gpg2-encrypted files.
Before signing in to Docker Desktop with your [Docker ID](../docker-id/_index.md), you must initialize `pass`.

10
content/desktop/hardened-desktop/_index.md
View File

@ -23,11 +23,11 @@ grid:
link: "/security/for-admins/image-access-management/"
---
>Note
> **Note**
>
>Hardened Docker Desktop is available to Docker Business customers only.
> Hardened Docker Desktop is available to Docker Business customers only.
## What is Hardened Docker Desktop?
### What is Hardened Docker Desktop?
Hardened Docker Desktop is a group of security features for Docker Desktop, designed to improve the security of developer environments without impacting developer experience or productivity.
@ -35,14 +35,14 @@ It lets admins define and enforce robust security settings. It guarantees that d
Hardened Docker Desktop moves the ownership boundary for Docker Desktop configuration to the organization, meaning that any security controls admins set cannot be altered by the user of Docker Desktop.
## Who is it for?
### Who is it for?
It is for security conscious organizations who:
- Don’t give their users root or admin access on their machines
- Would like Docker Desktop to be within their organization’s centralized control
- Have certain compliance obligations
## What does Hardened Docker Desktop include?
### What does Hardened Docker Desktop include?
It includes:
- Settings Management, which helps admins to confidently manage and control the usage of Docker Desktop within their organization.

3
content/desktop/hardened-desktop/settings-management/configure.md
View File

@ -31,9 +31,10 @@ To set it up manually:
By placing this file in the above protected directories, end users are unable to modify it.
>**Note**
> **Important**
>
> It is assumed that you have the ability to push the `admin-settings.json` settings file to the locations specified above through a device management software such as [Jamf](https://www.jamf.com/lp/en-gb/apple-mobile-device-management-mdm-jamf-shared/?attr=google_ads-brand-search-shared&gclid=CjwKCAjw1ICZBhAzEiwAFfvFhEXjayUAi8FHHv1JJitFPb47C_q_RCySTmF86twF1qJc_6GST-YDmhoCuJsQAvD_BwE).
{ .important }
### Step two: Configure the settings you want to lock in

BIN
content/desktop/images/dashboard.webp Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 54 KiB

22
content/desktop/install/debian.md
View File

@ -20,24 +20,6 @@ To install Docker Desktop successfully, you must:
- Meet the [system requirements](linux-install.md#system-requirements).
- Have a 64-bit version of Debian 12.
- Uninstall the tech preview or beta version of Docker Desktop for Linux. Run:
```console
$ sudo apt remove docker-desktop
```
For a complete cleanup, remove configuration and data files at `$HOME/.docker/desktop`, the symlink at `/usr/local/bin/com.docker.cli`, and purge the remaining systemd service files.
```console
$ rm -r $HOME/.docker/desktop
$ sudo rm /usr/local/bin/com.docker.cli
$ sudo apt purge docker-desktop
```
> **Note**
>
> If you have installed the Docker Desktop for Linux tech preview or beta version, you need to remove all files that were generated by those packages (eg. `~/.config/systemd/user/docker-desktop.service`, `~/.local/share/systemd/user/docker-desktop.service`).
- For a Gnome Desktop environment, you must also install AppIndicator and KStatusNotifierItem [Gnome extensions](https://extensions.gnome.org/extension/615/appindicator-support/).
- For non-Gnome Desktop environments, `gnome-terminal` must be installed:
@ -51,7 +33,7 @@ To install Docker Desktop successfully, you must:
Recommended approach to install Docker Desktop on Debian:
1. Set up Docker's `apt` repository.
See [Install using the `apt` repository, step 1](../../engine/install/debian.md#install-using-the-repository).
See step one of [Install using the `apt` repository](../../engine/install/debian.md#install-using-the-repository).
2. Download latest [DEB package](https://desktop.docker.com/linux/main/amd64/docker-desktop-4.26.1-amd64.deb?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64).
@ -95,6 +77,6 @@ $ sudo apt-get install ./docker-desktop-<version>-<arch>.deb
## Next steps
- Take a look at the [Get started](../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application.
- Take a look at the [Get started](../../guides/get-started/_index.md) training modules to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.

2
content/desktop/install/fedora.md
View File

@ -66,6 +66,6 @@ $ sudo dnf install ./docker-desktop-<version>-<arch>.rpm
## Next steps
- Take a look at the [Get started](../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application.
- Take a look at the [Get started](../../guides/get-started/_index.md) training modules to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.

12
content/desktop/install/linux-install.md
View File

@ -13,7 +13,7 @@ aliases:
This page contains information about general system requirements, supported platforms, and instructions on how to install Docker Desktop for Linux.
>Important
> **Important**
>
>Docker Desktop on Linux runs a Virtual Machine (VM) which creates and uses a custom docker context, `desktop-linux`, on startup.
>
@ -41,7 +41,7 @@ An experimental package is available for [Arch](archlinux.md)-based distribution
Docker supports Docker Desktop on the current LTS release of the aforementioned distributions and the most recent version. As new versions are made available, Docker stops supporting the oldest version and supports the newest version.
## System requirements
## General system requirements
To install Docker Desktop successfully, your Linux host must meet the following general requirements:
@ -59,7 +59,7 @@ Docker Desktop for Linux runs a Virtual Machine (VM). For more information on wh
> **Note**
>
> Docker does not provide support for running Docker Desktop in nested virtualization scenarios. We recommend that you run Docker Desktop for Linux natively on supported distributions.
> Docker does not provide support for running Docker Desktop for Linux in nested virtualization scenarios. We recommend that you run Docker Desktop for Linux natively on supported distributions.
### KVM virtualization support
@ -122,7 +122,9 @@ Sign out and sign back in so that your group membership is re-evaluated.
> employees OR more than $10 million USD in annual revenue) requires a paid
> subscription.
Make sure you meet the system requirements outlined earlier and follow the distro-specific prerequisites.
> **Important**
>
> Make sure you meet the system requirements outlined earlier and follow the distro-specific prerequisites.
{ .important }
1. Download the correct package for your Linux distribution and install it with the corresponding package manager.
@ -146,7 +148,7 @@ Make sure you meet the system requirements outlined earlier and follow the distr
## Where to go next
- [Get started with Docker](../../get-started/index.md) provides a general Docker tutorial.
- [Get started with Docker](../../guides/get-started/_index.md).
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.

18
content/desktop/install/mac-install.md
View File

@ -67,13 +67,13 @@ Beginning with Docker Desktop 4.3.0, we have removed the hard requirement to ins
{{< tabs >}}
{{< tab name="Install interactively" >}}
1. Double-click `Docker.dmg` to open the installer, then drag the Docker icon to
the **Applications** folder.
1. Download the installer using the download buttons at the top of the page, or from the [release notes](../release-notes.md).
2. Double-click `Docker.dmg` to open the installer, then drag the Docker icon to the **Applications** folder.
2. Double-click `Docker.app` in the **Applications** folder to start Docker.
3. Double-click `Docker.app` in the **Applications** folder to start Docker.
3. The Docker menu displays the Docker Subscription Service Agreement.
4. The Docker menu displays the Docker Subscription Service Agreement.
Here’s a summary of the key points:
- Docker Desktop is free for small businesses (fewer than 250 employees AND less than $10 million in annual revenue), personal use, education, and non-commercial open source projects.
@ -81,20 +81,20 @@ Beginning with Docker Desktop 4.3.0, we have removed the hard requirement to ins
- Paid subscriptions are also required for government entities.
- Docker Pro, Team, and Business subscriptions include commercial use of Docker Desktop.
4. Select **Accept** to continue.
5. Select **Accept** to continue.
Note that Docker Desktop won't run if you do not agree to the terms. You can choose to accept the terms at a later date by opening Docker Desktop.
For more information, see [Docker Desktop Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement). We recommend that you also read the [FAQs](https://www.docker.com/pricing/faq).
5. From the installation window, select either:
6. From the installation window, select either:
- **Use recommended settings (Requires password)**. This let's Docker Desktop automatically set the necessary configuration settings.
- **Use advanced settings**. You can then set the location of the Docker CLI tools either in the system or user directory, enable the default Docker socket, and enable privileged port mapping. See [Settings](../settings/mac.md#advanced), for more information and how to set the location of the Docker CLI tools.
6. Select **Finish**. If you have applied any of the above configurations that require a password in step 5, enter your password to confirm your choice.
7. Select **Finish**. If you have applied any of the above configurations that require a password in step 6, enter your password to confirm your choice.
{{< /tab >}}
{{< tab name="Install from the command line" >}}
After downloading `Docker.dmg`, run the following commands in a terminal to install Docker Desktop in the **Applications** folder:
After downloading `Docker.dmg` from either the download buttons at the top of the page or from the [release notes](../release-notes.md), run the following commands in a terminal to install Docker Desktop in the **Applications** folder:
```console
$ sudo hdiutil attach Docker.dmg
@ -122,7 +122,7 @@ The `install` command accepts the following flags:
## Where to go next
- [Get started with Docker](../../get-started/index.md) provides a general Docker tutorial.
- [Get started with Docker](../../guides/get-started/_index.md).
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how
to run and submit diagnostics, and submit issues.

22
content/desktop/install/ubuntu.md
View File

@ -28,30 +28,12 @@ To install Docker Desktop successfully, you must:
```console
$ sudo apt install gnome-terminal
```
- Uninstall the tech preview or beta version of Docker Desktop for Linux. Run:
```console
$ sudo apt remove docker-desktop
```
For a complete cleanup, remove configuration and data files at `$HOME/.docker/desktop`, the symlink at `/usr/local/bin/com.docker.cli`, and purge the remaining systemd service files.
```console
$ rm -r $HOME/.docker/desktop
$ sudo rm /usr/local/bin/com.docker.cli
$ sudo apt purge docker-desktop
```
> **Note**
>
> If you have installed the Docker Desktop for Linux tech preview or beta version, you need to remove all files that were generated by those packages (e.g., `~/.config/systemd/user/docker-desktop.service`, `~/.local/share/systemd/user/docker-desktop.service`).
## Install Docker Desktop
Recommended approach to install Docker Desktop on Ubuntu:
1. Set up Docker's package repository.
See [Install using the `apt` repository, step 1](../../engine/install/ubuntu.md#install-using-the-repository).
See step one of [Install using the `apt` repository](../../engine/install/ubuntu.md#install-using-the-repository).
2. Download latest [DEB package](https://desktop.docker.com/linux/main/amd64/docker-desktop-4.26.1-amd64.deb?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64).
@ -95,6 +77,6 @@ $ sudo apt-get install ./docker-desktop-<version>-<arch>.deb
## Next steps
- Take a look at the [Get started](../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application.
- Take a look at the [Get started](../../guides/get-started/_index.md) training modules to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.

27
content/desktop/install/windows-install.md
View File

@ -124,23 +124,28 @@ Looking for information on using Windows containers?
{{< tabs >}}
{{< tab name="Install interactively" >}}
1. Double-click **Docker Desktop Installer.exe** to run the installer.
1. Download the installer using the download button at the top of the page, or from the [release notes](../release-notes.md).
2. When prompted, ensure the **Use WSL 2 instead of Hyper-V** option on the Configuration page is selected or not depending on your choice of backend.
2. Double-click `Docker Desktop Installer.exe` to run the installer.
3. When prompted, ensure the **Use WSL 2 instead of Hyper-V** option on the Configuration page is selected or not depending on your choice of backend.
If your system only supports one of the two options, you will not be able to select which backend to use.
3. Follow the instructions on the installation wizard to authorize the installer and proceed with the install.
4. Follow the instructions on the installation wizard to authorize the installer and proceed with the install.
4. When the installation is successful, select **Close** to complete the installation process.
5. When the installation is successful, select **Close** to complete the installation process.
5. If your admin account is different to your user account, you must add the user to the **docker-users** group. Run **Computer Management** as an **administrator** and navigate to **Local Users and Groups** > **Groups** > **docker-users**. Right-click to add the user to the group.
Sign out and sign back in for the changes to take effect.
If your admin account is different to your user account, you must add the user to the **docker-users** group:
1. Run **Computer Management** as an **administrator**.
2. Navigate to **Local Users and Groups** > **Groups** > **docker-users**.
3. Right-click to add the user to the group.
4. Sign out and sign back in for the changes to take effect.
{{< /tab >}}
{{< tab name="Install from the command line" >}}
After downloading **Docker Desktop Installer.exe**, run the following command in a terminal to install Docker Desktop:
After downloading `Docker Desktop Installer.exe`, run the following command in a terminal to install Docker Desktop:
```console
$ "Docker Desktop Installer.exe" install
@ -182,6 +187,12 @@ The `install` command accepts the following flags:
- `--wsl-default-data-root=<path>`: Specifies the default location for the WSL distribution disk.
- `--always-run-service`: Lets users switch to Windows containers without needing admin rights.
> **Note**
>
> If you're using PowerShell, you need to use the `ArgumentList` parameter before any flags.
> For example:
> `Start-Process 'Docker Desktop Installer.exe' -Wait -ArgumentList 'install', '--accept-license`
If your admin account is different to your user account, you must add the user to the **docker-users** group:
```console
@ -211,7 +222,7 @@ Docker Desktop does not start automatically after installation. To start Docker
## Where to go next
- [Get started with Docker](/get-started/) is a tutorial that teaches you how to deploy a multi-service stack.
- [Get started with Docker](../../guides/get-started/_index.md).
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, and
how to get support.

6
content/desktop/settings/mac.md
View File

@ -291,6 +291,10 @@ Turns on the containerd image store. This brings new features like faster contai
{{< include "desktop-experimental.md" >}}
## Notifications
{{< include "desktop-notifications-settings.md" >}}
## Advanced
On the **Advanced** tab, you can reconfigure your initial installation settings:
@ -320,6 +324,4 @@ On the **Advanced** tab, you can reconfigure your initial installation settings:
You are notified if changes are found and are able to restore the configuration directly from the notification.
## Notifications
{{< include "desktop-notifications-settings.md" >}}

2
content/desktop/troubleshoot/known-issues.md
View File

@ -62,7 +62,7 @@ title: Known issues
{{< tab name="For Mac with Apple silicon" >}}
- On Apple silicon in native `arm64` containers, older versions of `libssl` such as `debian:buster`, `ubuntu:20.04`, and `centos:8` will segfault when connected to some TLS servers, for example, `curl https://dl.yarnpkg.com`. The bug is fixed in newer versions of `libssl` in `debian:bullseye`, `ubuntu:21.04`, and `fedora:35`.
- Some command line tools do not work when Rosetta 2 is not installed.
- The old version 1.x of `docker-compose`. Use Compose V2 instead. Either type `docker compose` or enable the **Use Docker Compose V2** option in the [General preferences tab](../settings/mac.md#general).
- The old version 1.x of `docker-compose`. Use Compose V2 instead - type `docker compose`.
- The `docker-credential-ecr-login` credential helper.
- Some images do not support the ARM64 architecture. You can add `--platform linux/amd64` to run (or build) an Intel image using emulation.

16
content/desktop/uninstall.md
View File

@ -4,6 +4,13 @@ keywords: Windows, unintall, Mac, Linux, Docker Desktop
title: Uninstall Docker Desktop
---
> **Warning**
>
> Uninstalling Docker Desktop destroys Docker containers, images, volumes, and
> other Docker-related data local to the machine, and removes the files generated
> by the application. To learn how to preserve important data before uninstalling, refer to the [back up and restore data](backup-and-restore.md) section .
{ .warning }
{{< tabs >}}
{{< tab name="Windows" >}}
@ -108,7 +115,7 @@ $ sudo rm /usr/local/bin/com.docker.cli
$ sudo apt purge docker-desktop
```
Remove the `credsStore` and `currentContext` properties from `$HOME/.docker/config.json`. Additionally, you must delete any edited configuration files manually. preserve important data before uninstalling.
Remove the `credsStore` and `currentContext` properties from `$HOME/.docker/config.json`. Additionally, you must delete any edited configuration files manually.
{{< /tab >}}
{{< tab name="Fedora" >}}
@ -152,9 +159,4 @@ Remove the `credsStore` and `currentContext` properties from `$HOME/.docker/conf
{{< /tab >}}
{{< /tabs >}}
> **Important**
>
> Uninstalling Docker Desktop destroys Docker containers, images, volumes, and
> other Docker-related data local to the machine, and removes the files generated
> by the application. To learn how to preserve important data before uninstalling, refer to the [back up and restore data](backup-and-restore.md) section .
{ .important }

2
content/desktop/use-desktop/_index.md
View File

@ -9,7 +9,7 @@ aliases:
When you open Docker Desktop, the Docker Dashboard displays.
![Docker Dashboard on Containers view](../images/dashboard.PNG)
![Docker Dashboard on Containers view](../images/dashboard.webp)
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](container.md).

19
content/desktop/use-desktop/builds.md
View File

@ -35,7 +35,9 @@ that you've removed from your system, or builders that have been stopped.
To inspect a build, select the build that you want to view in the list.
The inspection view contains a number of tabs:
### Info tab
{{< tabs >}}
{{< tab name="Info" >}}
The **Info** tab displays details about the build.
@ -93,24 +95,28 @@ The **Build results** section shows a summary of the generated build artifacts,
including the image manifest media type and digest, and information about build
attestations such as SBOM and provenance data.
### Source tab
{{< /tab >}}
{{< tab name="Sources" >}}
The **Source** tab shows the [frontend](../../build/dockerfile/frontend.md)
used to create the build.
### Error tab
{{< /tab >}}
{{< tab name="Error" >}}
The **Error** tab appears if the build finished with an error.
If the error was caused by an issue with the frontend, this tab displays the
frontend source with the error message inline where the build failed.
### Logs tab
{{< /tab >}}
{{< tab name="Logs" >}}
The **Logs** tab displays the build logs. If the build is currently running,
the logs are updated in real-time.
### History tab
{{< /tab >}}
{{< tab name="History" >}}
The **History** tab displays statistics data about completed builds.
@ -121,6 +127,9 @@ identifying trends and changes in your build operations over time.
You can navigate to and inspect a related build by selecting it in the chart,
or in the **Past builds** list below the history tab.
{{< /tab >}}
{{< /tabs >}}
## Manage builders
To inspect your builders, and change your default builder, select **Builder

11
content/desktop/use-desktop/container.md
View File

@ -47,7 +47,7 @@ Select **Inspect** to view low-level information about the container. It display
### Integrated terminal
From the **Terminal** tab, lets you use the integrated terminal, on a running container, directly within Docker Desktop. You are able to quickly run commands within your container so you can understand its current state or debug when something goes wrong.
From the **Exec** tab, lets you use the integrated terminal, on a running container, directly within Docker Desktop. You are able to quickly run commands within your container so you can understand its current state or debug when something goes wrong.
Using the integrated terminal is the same as running `docker exec -it <container-id> /bin/sh`, or `docker exec -it <container-id> cmd.exe` if you are using Windows containers, in your external terminal. It also:
@ -57,7 +57,7 @@ Using the integrated terminal is the same as running `docker exec -it <container
To open the integrated terminal, either:
- Hover over your running container and select the **Show container actions** menu. From the drop-down menu, select **Open in terminal**.
- Select the container and then select the **Terminal** tab.
- Select the container and then select the **Exec** tab.
To use your external terminal, navigate to the **General** tab in **Settings** and select the **System default** option under **Choose your terminal**.
@ -68,4 +68,9 @@ To use your external terminal, navigate to the **General** tab in **Settings** a
- Edit a file straight from the built-in editor
- Drag and drop files and folders between the host and the container
- Delete unnecessary files when you right-click on a file
- Download file and folders from the container straight to the host
- Download file and folders from the container straight to the host
## Additional resources
- [What is a container](../../guides/walkthroughs/what-is-a-container.md)
- [Run a container](../../guides/walkthroughs/run-a-container.md)
- [Run multi-container applications](../../guides/walkthroughs/multi-container-apps.md)

15
content/desktop/use-desktop/images.md
View File

@ -77,19 +77,10 @@ Select the image from the list, select the **More options** button and select **
>
> To remove an image used by a running or a stopped container, you must first remove the associated container.
You can remove individual images or use the **Clean up** option to delete unused and dangling images.
An unused image is an image which is not used by any running or stopped containers. An image becomes dangling when you build a new version of the image with the same tag.
To remove individual images, select the image from the list, select the **More options** button and select **Remove**
To remove individual images, select the bin icon.
To remove an unused or a dangling image:
1. Select the **Clean up** option from the **Images on disk** status bar.
2. Use the **Unused** or **Dangling** check boxes to select the type of images you would like to remove.
The **Clean up** images status bar displays the total space you can reclaim by removing the selected images.
3. Select **Remove** to confirm.
## Interact with remote repositories
@ -144,3 +135,7 @@ To connect a new Artifactory registry to Docker Desktop:
When signed in, a new **Artifactory** tab appears in the **Images** view.
By default, the image list shows images sorted by push date: the newest images appear higher in the list.
## Additional resources
- [Run Docker Hub images](../../guides/walkthroughs/run-hub-images.md)
- [Publish your image](../../guides/walkthroughs/publish-your-image.md)

2
content/desktop/use-desktop/pause.md
View File

@ -13,5 +13,5 @@ When you manually pause Docker Desktop, a paused status displays on the Docker m
>**Tip**
>
> The Resource Saver feature, available in Docker Desktop version 4.24 and later, is enabled by default and provides better
> CPU and memory savings and the manual Pause feature. See [here](resource-saver.md) for more info.
> CPU and memory savings than the manual Pause feature. See [here](resource-saver.md) for more info.
{ .tip }

10
content/desktop/use-desktop/resource-saver.md
View File

@ -30,17 +30,15 @@ changing `autoPauseTimeoutSeconds` in the Docker Desktop `settings.json` file:
There's no need to restart Docker Desktop after reconfiguring.
When Docker Desktop enters Resource Saver mode, a leaf icon displays on the
When Docker Desktop enters Resource Saver mode:
- A leaf icon displays on the
Docker Desktop status bar as well as on the Docker icon in
the system tray. The following image shows the Linux VM CPU and memory utilization reduced
to zero when Resource Saver mode is on.
![Resource Saver Status Bar](../images/resource-saver-status-bar.png)
![Resource Saver Status Bar](../images/resource-saver-status-bar.png)
When Docker Desktop enters Resource Saver mode, Docker commands that don't run
containers, for example listing container images or volumes, don't necessarily
trigger an exit from Resource Saver mode as Docker Desktop can serve such
commands without unnecessarily waking up the Linux VM.
- Docker commands that don't run containers, for example listing container images or volumes, don't necessarily trigger an exit from Resource Saver mode as Docker Desktop can serve such commands without unnecessarily waking up the Linux VM.
> **Note**
>

5
content/desktop/use-desktop/volumes.md
View File

@ -35,4 +35,7 @@ To delete a file or a folder from the volume, select **Remove** from the **More
Removing a volume deletes the volume and all its data.
To remove a volume, hover over the volume and then select the **Delete** icon. Alternatively, select the volume from the list and then select the **Delete** button.
To remove a volume, hover over the volume and then select the **Delete** icon. Alternatively, select the volume from the list and then select the **Delete** button.
## Additional resources
- [Persist container data](../../guides/walkthroughs/persist-data.md)

4
content/includes/desktop-linux-launch.md
View File

@ -38,8 +38,8 @@ Client: Docker Engine - Community
<...>
```
To enable Docker Desktop to start on login, from the Docker menu, select
**Settings** > **General** > **Start Docker Desktop when you log in**.
To enable Docker Desktop to start on sign in, from the Docker menu, select
**Settings** > **General** > **Start Docker Desktop when you sign in to your computer**.
Alternatively, open a terminal and run:

2
data/toc.yaml
View File

@ -1258,7 +1258,7 @@ Manuals:
- path: /desktop/extensions/settings-feedback/
title: Change settings and give feedback
- path: /desktop/extensions/private-marketplace/
title: Configure a private marketplace (Beta)
title: Configure a private marketplace (Experimental)
- sectiontitle: Extensions SDK
section:
- path: /desktop/extensions-sdk/

2
layouts/shortcodes/desktop-install.html
View File

@ -4,7 +4,7 @@
{{- $linux := .Get "linux" -}}
{{- $version := .Get "version" -}}
{{- $build_path := .Get "build_path" -}}
<blockquote {{ if eq $build_path "/" }}class="tip" {{ end }}>
<blockquote {{ if eq $build_path "/" }} class="tip" {{ end }}>
<p>Download Docker Desktop</p>
<p>
{{- if or $all $win }}