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

Fix numbered list issue 

Signed-off-by: Usha Mandya <usha.mandya@docker.com>
This commit is contained in:
Usha Mandya 2022-02-01 19:06:32 +00:00
parent f684196cf9
commit 3db5a1ddfb
1 changed files with 15 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
desktop/linux/index.md
View File

@ -27,13 +27,13 @@ To install Docker Desktop for Linux:
$ curl https://desktop-stage.docker.com/linux/main/amd64/74134/docker-desktop.deb --output docker-desktop.deb
$ sudo apt install ./docker-desktop.deb
```
3. Check whether the user belongs to `docker` and `kvm` groups. You may need to restart the host to load the group configuration (automated in post-install script).
3. Check whether the user belongs to `docker` and `kvm` groups. You may need to restart the host to load the group configuration (automated in post-install script).
There are a few post-install configuration steps done through the maintainers' scripts (post-install script contained
in the deb package.
There are a few post-install configuration steps done through the maintainers' scripts (post-install script contained
in the deb package.
For each user, the post-install script:
- installs systemd units
- configures `desktop-linux` as the default Docker CLI context
- installs Compose and the `docker scan` plugins to `~/.docker/cli-plugins`
@ -41,17 +41,15 @@ To install Docker Desktop for Linux:
- adds user to `docker` and `kvm` groups
In addition, the post-install script:
- sets the capability on the Docker Desktop binary to map privileged ports and set resource limits
- adds a DNS name for Kubernetes to `/etc/hosts`
- creates the Docker Desktop file for the application launcher
## Check the shared memory
Before you run Docker Desktop for Linux, verify whether the shared memory available on the host is **higher** than the memory allocated to the VM. By default, Docker Desktop allocates half of the memory and CPU from the host. The **available shared memory** should be higher than this.
```console
$ df -h /dev/shm
Filesystem Size Used Avail Use% Mounted on
@ -78,8 +76,8 @@ none /dev/shm tmpfs defaults,size=8G 0 0
## Launch Docker Desktop
> **Note:**
>
> **Note:**
>
> You may need to restart the host to load the group configuration.
To start Docker Desktop for Linux, search **Docker Desktop** on the
@ -147,7 +145,7 @@ To create and upload a diagnostics bundle:
1. From the Docker menu, select **Troubleshoot** > **Get support**.
2. When the diagnostics are available, click **Upload to get a Diagnostic ID**.
3. Make a note of the Diagnostic ID displayed on the Support page. You can send this ID with your bug report to investigate any issues.
**Troubleshoot** > **Get support**. Wait for a bundle to be generated, once uploaded, it displays a diagnostics ID that can be sent to us for investigation.
**Troubleshoot** > **Get support**. Wait for a bundle to be generated, once uploaded, it displays a diagnostics ID that can be sent to us for investigation.
Or, if you prefer to investigate the issue, you can access Docker Desktop logs by running the following command:
@ -166,12 +164,11 @@ To remove Docker Desktop for Linux, run:
$ sudo apt remove docker-desktop
```
## Known issues
- The Docker CLI login flow has some inconsistencies that we are currently investigating. If you experience any issues when trying to log in, remove the `credsStore` property from `~/.docker/config.json` and restart Docker Desktop (run either
- The Docker CLI login flow has some inconsistencies that we are currently investigating. If you experience any issues when trying to log in, remove the `credsStore` property from `~/.docker/config.json` and restart Docker Desktop (run either
`systemctl --user restart docker-desktop` or quit Docker Desktop and relaunch).
- Docker Desktop stores the passwords in base-64 encoded plaintext. Integration with `pass` is currently a work in progress.
- After launching Docker Desktop, you must remove `~/.docker/scan/config.json` for `docker scan` to work.
@ -179,11 +176,11 @@ $ sudo apt remove docker-desktop
- Dev Environments are not yet available.
- At the end of the installation process, `apt` displays an error due to installing a downloaded package. You can ignore this error message.
```
N: Download is performed unsandboxed as root, as file '/home/user/Downloads/docker-desktop.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)
```
## Why Docker Desktop for Linux runs a VM
Docker Desktop for Linux runs a Virtual Machine (VM) for the following reasons:
@ -197,10 +194,10 @@ Docker Desktop for Linux runs a Virtual Machine (VM) for the following reasons:
match that of Windows and macOS.
This need to deliver a consistent experience across all major OSs will become increasingly important as we look towards adding exciting new features, such as Docker Extensions, to Docker Desktop that will benefit users across all tiers. We’ll provide more details on these at [DockerCon22](https://www.docker.com/dockercon/){: target="_blank" rel="noopener" class="_"}. Watch this space.
2. **To make use of new kernel features**
Sometimes we want to make use of new operating system features. Because we control the kernel and the OS inside the VM, we can roll these out to all users immediately, even to users who are intentionally sticking on an LTS version of their machine OS.
Sometimes we want to make use of new operating system features. Because we control the kernel and the OS inside the VM, we can roll these out to all users immediately, even to users who are intentionally sticking on an LTS version of their machine OS.
3. **To enhance security**
@ -213,5 +210,3 @@ Sometimes we want to make use of new operating system features. Because we contr
The VM utilized by DD4L uses `virtiofs`, a shared file system that allows virtual machines to access a directory tree located on the host. Our internal benchmarking shows that with the right resource allocation to the VM, near native file system performance can be achieved with virtiofs.
As such, we have adjusted the default memory available to the VM in DD4L. You can tweak this setting to your specific needs by using the **Memory** slider within the **Settings** > **Resources** tab of Docker Desktop.