mirror of https://github.com/docker/docs.git
184 lines
8.8 KiB
Markdown
184 lines
8.8 KiB
Markdown
---
|
|
title: Install Docker Engine
|
|
description: Lists the installation methods
|
|
keywords: docker, installation, install, Docker Engine, Docker Engine, docker editions, stable, edge
|
|
redirect_from:
|
|
- /cs-engine/
|
|
- /cs-engine/1.12/
|
|
- /cs-engine/1.12/upgrade/
|
|
- /cs-engine/1.13/
|
|
- /cs-engine/1.13/upgrade/
|
|
- /ee/docker-ee/oracle/
|
|
- /ee/supported-platforms/
|
|
- /en/latest/installation/
|
|
- /engine/installation/
|
|
- /engine/installation/frugalware/
|
|
- /engine/installation/linux/
|
|
- /engine/installation/linux/archlinux/
|
|
- /engine/installation/linux/cruxlinux/
|
|
- /engine/installation/linux/docker-ce/
|
|
- /engine/installation/linux/docker-ee/
|
|
- /engine/installation/linux/docker-ee/oracle/
|
|
- /engine/installation/linux/frugalware/
|
|
- /engine/installation/linux/gentoolinux/
|
|
- /engine/installation/linux/oracle/
|
|
- /engine/installation/linux/other/
|
|
- /engine/installation/oracle/
|
|
- /enterprise/supported-platforms/
|
|
- /install/linux/docker-ee/oracle/
|
|
---
|
|
|
|
> **Docker Desktop for Linux**
|
|
>
|
|
> Docker Desktop helps you build, share, and run containers easily on Mac and Windows as you do on Linux. Docker handles the complex setup and allows you to focus on writing the code. Thanks to the positive support we received on the [subscription updates](https://www.docker.com/blog/updating-product-subscriptions/){: target="_blank" rel="noopener" class="_" id="dkr_docs_cta"}, we've started working on [Docker Desktop for Linux](https://www.docker.com/blog/accelerating-new-features-in-docker-desktop/){: target="_blank" rel="noopener" class="_" id="dkr_docs_cta"} which is the second-most popular feature request in our public roadmap. If you are interested in early access, sign up for our [Developer Preview program](https://www.docker.com/community/get-involved/developer-preview){: target="_blank" rel="noopener" class="_" id="dkr_docs_cta"}.
|
|
{: .important}
|
|
|
|
## Supported platforms
|
|
|
|
Docker Engine is available on a variety of [Linux platforms](#server),
|
|
[macOS](../../desktop/mac/install.md) and [Windows 10](../../desktop/windows/install.md)
|
|
through Docker Desktop, and as a [static binary installation](binaries.md). Find
|
|
your preferred operating system below.
|
|
|
|
### Desktop
|
|
|
|
{% assign yes = '{: .inline style="height: 14px; margin: 0 auto"}' %}
|
|
|
|
| Platform | x86_64 / amd64 | arm64 (Apple Silicon) |
|
|
|:------------------------------------------------------------------|:------------------------------------------------:|:------------------------------------------------:|
|
|
| [Docker Desktop for Mac (macOS)](../../desktop/mac/install.md) | [{{ yes }}](../../desktop/mac/install.md) | [{{ yes }}](../../desktop/mac/install.md) |
|
|
| [Docker Desktop for Windows](../../desktop/windows/install.md) | [{{ yes }}](../../desktop/windows/install.md) | |
|
|
|
|
### Server
|
|
|
|
Docker provides `.deb` and `.rpm` packages from the following Linux distributions
|
|
and architectures:
|
|
|
|
| Platform | x86_64 / amd64 | arm64 / aarch64 | arm (32-bit) | s390x |
|
|
|:------------------------|:-----------------------|:-----------------------|:-----------------------|:-----------------------|
|
|
| [CentOS](centos.md) | [{{ yes }}](centos.md) | [{{ yes }}](centos.md) | | |
|
|
| [Debian](debian.md) | [{{ yes }}](debian.md) | [{{ yes }}](debian.md) | [{{ yes }}](debian.md) | |
|
|
| [Fedora](fedora.md) | [{{ yes }}](fedora.md) | [{{ yes }}](fedora.md) | | |
|
|
| [Raspbian](debian.md) | | | [{{ yes }}](debian.md) | |
|
|
| [RHEL](rhel.md) | | | | [{{ yes }}](rhel.md) |
|
|
| [SLES](sles.md) | | | | [{{ yes }}](sles.md) |
|
|
| [Ubuntu](ubuntu.md) | [{{ yes }}](ubuntu.md) | [{{ yes }}](ubuntu.md) | [{{ yes }}](ubuntu.md) | [{{ yes }}](ubuntu.md) |
|
|
| [Binaries](binaries.md) | [{{yes}}](binaries.md) | [{{yes}}](binaries.md) | [{{yes}}](binaries.md) | |
|
|
|
|
### Other Linux distributions
|
|
|
|
> **Note**
|
|
>
|
|
> While the instructions below may work, Docker does not test or verify
|
|
> installation on derivatives.
|
|
|
|
- Users of Debian derivatives such as "BunsenLabs Linux", "Kali Linux" or
|
|
"LMDE" (Debian-based Mint) should follow the installation instructions for
|
|
[Debian](debian.md), substituting the version of their distro for the
|
|
corresponding Debian release. Refer to the documentation of your distro to find
|
|
which Debian release corresponds with your derivative version.
|
|
- Likewise, users of Ubuntu derivatives such as "Kubuntu", "Lubuntu" or "Xubuntu"
|
|
should follow the installation instructions for [Ubuntu](ubuntu.md),
|
|
substituting the version of their distro for the corresponding Ubuntu release.
|
|
Refer to the documentation of your distro to find which Ubuntu release
|
|
corresponds with your derivative version.
|
|
- Some Linux distributions are providing a package of Docker Engine through their
|
|
package repositories. These packages are built and maintained by the Linux
|
|
distribution's package maintainers and may have differences in configuration
|
|
or built from modified source code. Docker is not involved in releasing these
|
|
packages and bugs or issues involving these packages should be reported in
|
|
your Linux distribution's issue tracker.
|
|
|
|
Docker provides [binaries](binaries.md) for manual installation of Docker Engine.
|
|
These binaries are statically linked and can be used on any Linux distribution.
|
|
|
|
## Release channels
|
|
|
|
Docker Engine has three types of update channels, **stable**, **test**,
|
|
and **nightly**:
|
|
|
|
* The **Stable** channel gives you latest releases for general availability.
|
|
* The **Test** channel gives pre-releases that are ready for testing before
|
|
general availability (GA).
|
|
* The **Nightly** channel gives you latest builds of work in progress for the
|
|
next major release.
|
|
|
|
### Stable
|
|
|
|
Year-month releases are made from a release branch diverged from the master
|
|
branch. The branch is created with format `<year>.<month>`, for example
|
|
`20.10`. The year-month name indicates the earliest possible calendar
|
|
month to expect the release to be generally available. All further patch
|
|
releases are performed from that branch. For example, once `v20.10.0` is
|
|
released, all subsequent patch releases are built from the `20.10` branch.
|
|
|
|
### Test
|
|
|
|
In preparation for a new year-month release, a branch is created from
|
|
the master branch with format `YY.mm` when the milestones desired by
|
|
Docker for the release have achieved feature-complete. Pre-releases
|
|
such as betas and release candidates are conducted from their respective release
|
|
branches. Patch releases and the corresponding pre-releases are performed
|
|
from within the corresponding release branch.
|
|
|
|
### Nightly
|
|
|
|
Nightly builds give you the latest builds of work in progress for the next major
|
|
release. They are created once per day from the master branch with the version
|
|
format:
|
|
|
|
0.0.0-YYYYmmddHHMMSS-abcdefabcdef
|
|
|
|
where the time is the commit time in UTC and the final suffix is the prefix
|
|
of the commit hash, for example `0.0.0-20180720214833-f61e0f7`.
|
|
|
|
These builds allow for testing from the latest code on the master branch. No
|
|
qualifications or guarantees are made for the nightly builds.
|
|
|
|
## Support
|
|
|
|
Docker Engine releases of a year-month branch are supported with patches as
|
|
needed for one month after the next year-month general availability release.
|
|
|
|
This means bug reports and backports to release branches are assessed
|
|
until the end-of-life date.
|
|
|
|
After the year-month branch has reached end-of-life, the branch may be
|
|
deleted from the repository.
|
|
|
|
### Backporting
|
|
|
|
Backports to the Docker products are prioritized by the Docker company. A
|
|
Docker employee or repository maintainer will endeavour to ensure sensible
|
|
bugfixes make it into _active_ releases.
|
|
|
|
If there are important fixes that ought to be considered for backport to
|
|
active release branches, be sure to highlight this in the PR description
|
|
or by adding a comment to the PR.
|
|
|
|
### Upgrade path
|
|
|
|
Patch releases are always backward compatible with its year-month version.
|
|
|
|
### Licensing
|
|
|
|
Docker is licensed under the Apache License, Version 2.0. See
|
|
[LICENSE](https://github.com/moby/moby/blob/master/LICENSE) for the full
|
|
license text.
|
|
|
|
## Reporting security issues
|
|
|
|
The Docker maintainers take security seriously. If you discover a security
|
|
issue, please bring it to their attention right away!
|
|
|
|
Please DO NOT file a public issue; instead send your report privately
|
|
to security@docker.com.
|
|
|
|
Security reports are greatly appreciated, and Docker will publicly thank you
|
|
for it.
|
|
|
|
## Get started
|
|
|
|
After setting up Docker, you can learn the basics with
|
|
[Getting started with Docker](../../get-started/index.md).
|