mirror of https://github.com/docker/docs.git
93 lines
4.4 KiB
Markdown
93 lines
4.4 KiB
Markdown
### Install using the convenience script
|
|
|
|
Docker provides a convenience script at
|
|
[https://get.docker.com/](https://get.docker.com/) to install Docker into
|
|
development environments non-interactively. The convenience script isn't
|
|
recommended for production environments, but it's useful for creating a
|
|
provisioning script 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 you can find it in the
|
|
[`docker-install` repository on GitHub](https://github.com/docker/docker-install).
|
|
|
|
<!-- prettier-ignore -->
|
|
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:
|
|
|
|
- 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.
|
|
- The script doesn't 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 upgrades in
|
|
a test environment before deploying to your production systems.
|
|
- The script isn't 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, resulting in outdated versions.
|
|
|
|
> [!TIP]
|
|
>
|
|
> Preview script steps before running. You can run the script with the `--dry-run` option to learn what steps the
|
|
> script will run when invoked:
|
|
>
|
|
> ```console
|
|
> $ curl -fsSL https://get.docker.com -o get-docker.sh
|
|
> $ sudo sh ./get-docker.sh --dry-run
|
|
> ```
|
|
|
|
This example downloads the script from
|
|
[https://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
|
|
<...>
|
|
```
|
|
|
|
You have now successfully installed and started Docker Engine. 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 can't 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).
|
|
> You can also install Docker 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
|
|
[https://test.docker.com/](https://test.docker.com/) to install pre-releases of
|
|
Docker on Linux. This script is equal to the script at `get.docker.com`, but
|
|
configures your package manager to use the test channel of the Docker package
|
|
repository. The test channel 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're
|
|
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's no advantage to re-running the
|
|
convenience script. Re-running it can cause issues if it attempts to re-install
|
|
repositories which already exist on the host machine.
|