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

Update DD4L doc page 

Signed-off-by: aiordache <anca.iordache@docker.com>
This commit is contained in:
aiordache 2022-03-25 18:56:09 +01:00
parent 0c9dfda8da
commit 38cc3d1d7e
1 changed files with 30 additions and 65 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

93
desktop/linux/index.md
View File

@ -24,62 +24,22 @@ To install Docker Desktop for Linux:
1. Set up the [Docker repository](../../engine/install/ubuntu.md#install-using-the-repository). 1. Set up the [Docker repository](../../engine/install/ubuntu.md#install-using-the-repository).
2. Download and install the Tech Preview Debian package: 2. Download and install the Tech Preview Debian package:
```console ```console
$ curl https://desktop-stage.docker.com/linux/main/amd64/74258/docker-desktop.deb --output docker-desktop.deb $ curl https://desktop-stage.docker.com/linux/main/amd64/76643/docker-desktop.deb --output docker-desktop.deb
$ sudo apt install ./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).
There are a few post-install configuration steps done through the maintainers' scripts (post-install script contained There are a few post-install configuration steps done through the maintainers' scripts (post-install script contained
in the deb package. in the deb package.
For each user, the post-install script: 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`
- enables Compose V2 as the default `docker-compose`
- 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 - 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` - adds a DNS name for Kubernetes to `/etc/hosts`
- creates the Docker Desktop file for the application launcher - creates a link from `/usr/bin/docker` to `/usr/local/bin/com.docker.cli`
- installs systemd units for each user
## 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
tmpfs 16G 200M 16G 2% /dev/shm
```
To set the shared memory size, run:
```console
$ sudo mount -o remount,size=<the-size-you-want-in-GB> /dev/shm
```
To ensure this setting persists after a reboot, add the following entry to the `/etc/fstab`:
```console
none /dev/shm tmpfs defaults,size=<the-size-you-want-in-GB> 0 0
```
For example:
```console
none /dev/shm tmpfs defaults,size=8G 0 0
```
## Launch Docker Desktop ## Launch Docker Desktop
> **Note:**
>
> You may need to restart the host to load the group configuration.
To start Docker Desktop for Linux, search **Docker Desktop** on the To start Docker Desktop for Linux, search **Docker Desktop** on the
**Applications** menu and open it. This launches the whale menu icon and opens **Applications** menu and open it. This launches the whale menu icon and opens
the Docker Dashboard, reporting the status of Docker Desktop. the Docker Dashboard, reporting the status of Docker Desktop.
@ -90,24 +50,23 @@ Alternatively, open a terminal and run:
$ systemctl --user start docker-desktop $ systemctl --user start docker-desktop
``` ```
When Docker Desktop starts, it creates a dedicated context that the Docker CLI can use as a target. This is to avoid a clash with a local Docker Engine that may be running on the Linux host and using the default context. When Docker Desktop starts, it creates a dedicated context that the Docker CLI
can use as a target and sets it as the current context in use. This is to avoid
Run the following command to switch to the desktop-linux context. a clash with a local Docker Engine that may be running on the Linux host and
using the default context. On shutdown, Docker Desktop resets the current
```console context to the previous one.
$ docker context use desktop-linux
```
The Docker Desktop installer updates Docker Compose and the Docker CLI binaries The Docker Desktop installer updates Docker Compose and the Docker CLI binaries
on the host. It installs Docker Compose V2 as the default Docker Compose. It on the host. It installs Docker Compose V2 and gives users the choice to
also replaces the default Docker CLI with a new Docker CLI binary that includes link it as docker-compose from the Settings panel. Docker Desktop installs
cloud-integration capabilities. the new Docker CLI binary that includes cloud-integration capabilities in `/usr/local/bin`
and creates a symlink to the classic Docker CLi at `/usr/local/bin/com.docker.cli`.
After you’ve successfully installed Docker Desktop, you can check the versions After you’ve successfully installed Docker Desktop, you can check the versions
of these binaries by running the following command: of these binaries by running the following command:
```console ```console
$ docker-compose version $ docker compose version
Docker Compose version v2.2.3 Docker Compose version v2.2.3
$ docker --version $ docker --version
@ -121,6 +80,12 @@ API version: 1.41
... ...
``` ```
> **Note:**
>
> Docker Desktop relies on `pass` to store credentials. Before signing in to Docker Hub
> from the Docker Dashboard or the Docker menu, you must initialize `pass`. Docker Desktop
> displays a warning message if `pass` is not initialized.
To enable Docker Desktop to start on login, from the Docker menu, select To enable Docker Desktop to start on login, from the Docker menu, select
**Settings** > **General** > **Start Docker Desktop when you log in**. **Settings** > **General** > **Start Docker Desktop when you log in**.
@ -164,17 +129,17 @@ To remove Docker Desktop for Linux, run:
$ sudo apt remove docker-desktop $ 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
```
## Known issues ## 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
`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.
- 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. - At the end of the installation process, `apt` displays an error due to installing a downloaded package. You can ignore this error message.
``` ```