mirror of https://github.com/docker/docs.git
92 lines
4.5 KiB
Markdown
92 lines
4.5 KiB
Markdown
<!-- This file is included in Docker Engine - Community or EE installation docs for Linux. -->
|
|
|
|
### Install using the convenience script
|
|
|
|
Docker provides a convenience script at [get.docker.com](https://get.docker.com/)
|
|
to install Docker into development environments quickly and non-interactively.
|
|
The convenience script is not recommended for production environments, but can be
|
|
used as an example to create a provisioning script that is tailored to your needs.
|
|
Also refer to the [install using the repository](#install-using-the-repository)
|
|
steps to learn about installation steps to install using the package repository.
|
|
The source code for the script is open source, and can be found in the
|
|
[`docker-install` repository on GitHub](https://github.com/docker/docker-install){:target="_blank" rel="noopener" class="_"}.
|
|
|
|
Always examine scripts downloaded from the internet before running them locally.
|
|
Before installing, make yourself familiar with potential risks and limitations
|
|
of the convenience script:
|
|
{:.warning}
|
|
|
|
- The script requires `root` or `sudo` privileges to run.
|
|
- The script attempts to detect your Linux distribution and version and
|
|
configure your package management system for you, and does not allow you to
|
|
customize most installation parameters.
|
|
- The script installs dependencies and recommendations without asking for
|
|
confirmation. This may install a large number of packages, depending on the
|
|
current configuration of your host machine.
|
|
- By default, the script installs the latest stable release of Docker, containerd,
|
|
and runc. When using this script to provision a machine, this may result in
|
|
unexpected major version upgrades of Docker. Always test (major) upgrades in
|
|
a test environment before deploying to your production systems.
|
|
- The script is not designed to upgrade an existing Docker installation. When
|
|
using the script to update an existing installation, dependencies may not be
|
|
updated to the expected version, causing outdated versions to be used.
|
|
|
|
> Tip: preview script steps before running
|
|
>
|
|
> You can run the script with the `DRY_RUN=1` option to learn what steps the
|
|
> script will execute during installation:
|
|
>
|
|
> ```console
|
|
> $ curl -fsSL https://get.docker.com -o get-docker.sh
|
|
> $ DRY_RUN=1 sh ./get-docker.sh
|
|
> ```
|
|
|
|
This example downloads the script from [get.docker.com](https://get.docker.com/)
|
|
and runs it to install the latest stable release of Docker on Linux:
|
|
|
|
```console
|
|
$ curl -fsSL https://get.docker.com -o get-docker.sh
|
|
$ sudo sh get-docker.sh
|
|
Executing docker install script, commit: 7cae5f8b0decc17d6571f9f52eb840fbc13b2737
|
|
<...>
|
|
```
|
|
|
|
Docker is installed. The `docker` service starts automatically on Debian based
|
|
distributions. On `RPM` based distributions, such as CentOS, Fedora, RHEL or SLES,
|
|
you need to start it manually using the appropriate `systemctl` or `service` command.
|
|
As the message indicates, non-root users cannot run Docker commands by default.
|
|
|
|
> **Use Docker as a non-privileged user, or install in rootless mode?**
|
|
>
|
|
> The installation script requires `root` or `sudo` privileges to install and
|
|
> use Docker. If you want to grant non-root users access to Docker, refer to the
|
|
> [post-installation steps for Linux](/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user).
|
|
> Docker can also be installed without `root` privileges, or configured to run
|
|
> in rootless mode. For instructions on running Docker in rootless mode, refer to
|
|
> [run the Docker daemon as a non-root user (rootless mode)](/engine/security/rootless/).
|
|
|
|
#### Install pre-releases
|
|
|
|
Docker also provides a convenience script at [test.docker.com](https://test.docker.com/)
|
|
to install pre-releases of Docker on Linux. This script is equivalent to the
|
|
script at `get.docker.com`, but configures your package manager to enable the
|
|
"test" channel from our package repository, which includes both stable and
|
|
pre-releases (beta versions, release-candidates) of Docker. Use this script to
|
|
get early access to new releases, and to evaluate them in a testing environment
|
|
before they are released as stable.
|
|
|
|
To install the latest version of Docker on Linux from the "test" channel, run:
|
|
|
|
```console
|
|
$ curl -fsSL https://test.docker.com -o test-docker.sh
|
|
$ sudo sh test-docker.sh
|
|
<...>
|
|
```
|
|
|
|
#### Upgrade Docker after using the convenience script
|
|
|
|
If you installed Docker using the convenience script, you should upgrade Docker
|
|
using your package manager directly. There is no advantage to re-running the
|
|
convenience script, and it can cause issues if it attempts to re-add
|
|
repositories which have already been added to the host machine.
|