Commit Graph

17 Commits

Author SHA1 Message Date
Ralph
3fa0164e4c Add quick troubleshooting step (#13887)
* Add quick troubleshooting step

If default umask isn't set with global read permissions, the keyring GPG file isn't found when updating the apt repos. The one liner command added will fix this issue.

* Fix grammar

Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
2021-11-26 12:56:45 +00:00
Sebastiaan van Stijn
e1791f5b7d engine: remove outdated instructions for derivatives
The information about which distro version to use to match upstream
Debian / Ubuntu versions was outdated. Given that Docker does not
officially support, nor tests, installing these packages on Ubuntu
and Debian derivatives, it's better to remove it, and leave it to
the user to find the correct codename; also see
https://docs.docker.com/engine/install/#other-linux-distributions

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-11-12 18:36:30 +01:00
Sebastiaan van Stijn
d601e97f75 engine/install: remove apt-transport-https from instructions
This package is no longer needed on all current distro versions we support. From
the package description (https://packages.debian.org/buster/apt-transport-https);

> This is a dummy transitional package - https support has been moved into the
> apt package in 1.5. It can be safely removed.

Verifying the version of apt that's available in Ubuntu and Debian:

Ubuntu:

    docker run --rm ubuntu:xenial apt --version
    apt 1.2.35 (amd64)

    docker run --rm ubuntu:17.04 apt --version
    apt 1.4.6 (amd64)

    docker run --rm ubuntu:17.10 apt --version
    apt 1.5.2 (amd64)

    docker run --rm ubuntu:18.04 apt --version
    apt 1.6.14 (amd64)

    docker run --rm ubuntu:20.04 apt --version
    apt 2.0.6 (amd64)

Debian:

    docker run --rm debian:stretch apt --version
    apt 1.4.11 (amd64)

    docker run --rm debian:buster apt --version
    apt 1.8.2.3 (amd64)

    docker run --rm debian:bullseye apt --version
    apt 2.2.4 (amd64)

From the above; all currently supported versions of Ubuntu (18.04 and up), and
Debian (old-stable and stable) have apt > 1.5, so we can remove this dependency
from the installation instructions.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-10-20 17:39:22 +02:00
Peter Dave Hello
1720aae2a2 Simplify Debian & Ubuntu Docker Engine installation guide 2021-10-02 15:39:32 +08:00
linuxmetel
5cd6f0ef11 Update debian.md
Update Debian's stable and Raspbian's stable
2021-08-23 15:50:03 +09:00
Sebastiaan van Stijn
3356fffaf0 engine/install: various copy-edits
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-08-05 21:30:56 +02:00
Sebastiaan van Stijn
c876e5cba7 engine: update list of distros that we build on
Adds new distros:

- Ubuntu 21.04 "hirsute hippo"
- Debian/Raspbian 11 "bullseye"
- Fedora 34

Removes Debian 9 "stretch", which reached EOL in upstream Debian

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-04-12 19:24:00 +02:00
Andrew Kester
891837abf9 Add lsb-release to required debian and ubuntu packages
Certain installations may not have this.  Without this, the step
where `/etc/apt/sources.list.d/docker.list` will fail and write
garbled data to the file, potentially breaking apt.

Co-Authored-By: Andrew Kester <akester@cox.net>
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-03-09 15:47:10 +01:00
Sebastiaan van Stijn
d95a4266ff replace "output truncated" with special <...> (supported by "rouge")
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-03-02 15:02:21 +01:00
Sebastiaan van Stijn
f4ba73ecbb engine/instal: use "console" code-hints for examples
This tones down the prompt and command output, so that the commands
to run stand out more clearly.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-03-02 15:02:12 +01:00
denis-roy
760bb64ea3 Offering an alternative to the deprecated apt-key tool (#11990)
* Offering an alternative to apt-key (deprecated)

[Use trusted.gpg.d instead of apt-key · Issue #11625 · docker/docker.github.io](https://github.com/docker/docker.github.io/issues/11625)

As of Debian 10 / Ubuntu 20.10, apt-key is deprecated and will not be available after Debian 11 / Ubuntu 22.04

Although adding keys directly to `/etc/apt/trusted.gpg.d`/ is suggested by apt-key deprecation message, as per [Debian Wiki](https://wiki.debian.org/DebianRepository/UseThirdParty) GPG keys for third party repositories should be added to `/usr/share/keyrings` and referenced with the `signed-by` option in the source.list.d entry.

Providing a binary .gpg key instead of an ASCII Armored one might help shorten the lengthy command by removing the ` | gpg --dearmor ` bit.

This removes the software-properties-common provides add-apt-repository which we don't use anymore
2021-03-02 11:30:37 +01:00
Sebastiaan van Stijn
393d3f6566 Add rel="noopener" to external links
See https://web.dev/external-anchors-use-rel-noopener/

Using noopener, as that addresses the security issue. "noreferer" blocks
the REFERER header, which may still be useful for some target URLs.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-10-12 13:09:30 +02:00
Paul
3b57ab426c Update debian.md
containerd package still in library
2020-06-20 20:59:43 -05:00
Sebastiaan van Stijn
777c5d23da engine: use relative markdown links
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-04-23 13:03:32 +02:00
m-aXimilian
22428abcc5 Update debian.md
Changed "Ubuntu" to "Debian"
2020-04-12 14:22:39 +02:00
Sebastiaan van Stijn
569f448ac7 engine: cleanup install page, add info about derivatives
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-04-06 14:04:27 +02:00
Sebastiaan van Stijn
d813acb6e1 Engine: reorganize install topic
- Move getting started overview to /get-started/overview/
- Move engine installation files under /engine/
- Redirect the top-level /install/ to /get-docker/
- Updated titles in left-hand navigation
- Added back some pages to the navigation that were
  currently not included.
- Reduce some steps in the installation pages
- Move devicemapper prerequisites to the devicemapper
  storage driver page.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-04-06 10:50:28 +02:00