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

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>
This commit is contained in:
Sebastiaan van Stijn 2020-03-18 13:22:58 +01:00
parent 73293d4e71
commit d813acb6e1
No known key found for this signature in database
GPG Key ID: 76698F39D527CE8C
44 changed files with 321 additions and 333 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
_data/toc.yaml
View File

@ -4,7 +4,7 @@ horizontalnav:
path: / path: /
node: guides node: guides
- title: Product manuals - title: Product manuals
path: /install/ path: /engine/
node: manuals node: manuals
- title: Reference - title: Reference
path: /reference/ path: /reference/
@ -1023,22 +1023,24 @@ samples:
manuals: manuals:
- sectiontitle: Docker Engine - sectiontitle: Docker Engine
section: section:
- path: /install/ - path: /engine/
title: Overview title: Overview
- sectiontitle: Linux - path: /engine/install/
title: Install
- sectiontitle: Installation per distro
section: section:
- path: /install/linux/docker-ce/centos/ - path: /engine/install/centos/
title: CentOS title: Install on CentOS
- path: /install/linux/docker-ce/debian/ - path: /engine/install/debian/
title: Debian title: Install on Debian
- path: /install/linux/docker-ce/fedora/ - path: /engine/install/fedora/
title: Fedora title: Install on Fedora
- path: /install/linux/docker-ce/ubuntu/ - path: /engine/install/ubuntu/
title: Ubuntu title: Install on Ubuntu
- path: /install/linux/docker-ce/binaries/ - path: /engine/install/binaries/
title: Binaries title: Install binaries
- path: /install/linux/linux-postinstall/ - path: /engine/install/linux-postinstall/
title: Optional Linux post-installation steps title: Optional post-installation steps
- path: /engine/release-notes/ - path: /engine/release-notes/
title: Release notes title: Release notes
- sectiontitle: Previous versions - sectiontitle: Previous versions
@ -1077,6 +1079,9 @@ manuals:
title: Engine 17.03 release notes title: Engine 17.03 release notes
- path: /engine/release-notes/prior-releases/ - path: /engine/release-notes/prior-releases/
title: Engine 1.13 and earlier title: Engine 1.13 and earlier
- path: /engine/deprecated/
title: Deprecated features
- path: /app/working-with-app/ - path: /app/working-with-app/
title: Docker App title: Docker App
- path: /buildx/working-with-buildx/ - path: /buildx/working-with-buildx/

12
_includes/ee-linux-install-reuse.md
View File

@ -23,7 +23,7 @@ on {{ linux-dist-long }}:
Docker Engine - Community is _not_ supported on {{ linux-dist-long }}. Docker Engine - Community is _not_ supported on {{ linux-dist-long }}.
{% endif %} {% endif %}
{% if linux-dist == "centos" %} {% if linux-dist == "centos" %}
For Docker Community Edition on {{ linux-dist-cap }}, see [Get Docker Engine - Community for CentOS](/install/linux/docker-ce/centos.md). For Docker Community Edition on {{ linux-dist-cap }}, see [Get Docker Engine - Community for CentOS](/engine/install/centos.md).
{% endif %} {% endif %}
{% elsif section == "find-ee-repo-url" %} {% elsif section == "find-ee-repo-url" %}
@ -280,7 +280,7 @@ You only need to set up the repository once, after which you can install Docker
``` ```
Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See
[Linux postinstall](/install/linux/linux-postinstall.md){: target="_blank" class="_" } to allow [Linux postinstall](/engine/install/linux-postinstall.md){: target="_blank" class="_" } to allow
non-privileged users to run Docker commands. non-privileged users to run Docker commands.
@ -351,7 +351,7 @@ To manually install Docker Enterprise, download the `.{{ package-format | downca
``` ```
Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See
[Linux postinstall](/install/linux/linux-postinstall.md){: target="_blank" class="_" } to allow [Linux postinstall](/engine/install/linux-postinstall.md){: target="_blank" class="_" } to allow
non-privileged users to run Docker commands. non-privileged users to run Docker commands.
</div> </div>
@ -394,7 +394,7 @@ To manually install Docker Enterprise, download the `.{{ package-format | downca
``` ```
Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See
[Linux postinstall](/install/linux/linux-postinstall.md){: target="_blank" class="_" } to allow [Linux postinstall](/engine/install/linux-postinstall.md){: target="_blank" class="_" } to allow
non-privileged users to run Docker commands. non-privileged users to run Docker commands.
</div> </div>
@ -444,7 +444,7 @@ To manually install Docker Enterprise, download the `.{{ package-format | downca
``` ```
Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See
[Linux postinstall](/install/linux/linux-postinstall.md){: target="_blank" class="_" } to allow [Linux postinstall](/engine/install/linux-postinstall.md){: target="_blank" class="_" } to allow
non-privileged users to run Docker commands. non-privileged users to run Docker commands.
{% endif %} {% endif %}
@ -485,7 +485,7 @@ You must delete any edited configuration files manually.
{% elsif section == "linux-install-nextsteps" %} {% elsif section == "linux-install-nextsteps" %}
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md){: target="_blank" class="_" } - Continue to [Post-installation steps for Linux](/engine/install/linux-postinstall.md){: target="_blank" class="_" }
- Continue with user guides on [Universal Control Plane (UCP)](/ee/ucp/){: target="_blank" class="_" } and [Docker Trusted Registry (DTR)](/ee/dtr/){: target="_blank" class="_" } - Continue with user guides on [Universal Control Plane (UCP)](/ee/ucp/){: target="_blank" class="_" } and [Docker Trusted Registry (DTR)](/ee/dtr/){: target="_blank" class="_" }

2
compose/aspnet-mssql-compose.md
View File

@ -9,7 +9,7 @@ Compose to set up and run the sample ASP.NET Core application using the
[.NET Core SDK image](https://hub.docker.com/_/microsoft-dotnet-core-sdk) [.NET Core SDK image](https://hub.docker.com/_/microsoft-dotnet-core-sdk)
with the with the
[SQL Server on Linux image](https://hub.docker.com/_/microsoft-mssql-server). [SQL Server on Linux image](https://hub.docker.com/_/microsoft-mssql-server).
You just need to have [Docker Engine](/install/index.md) You just need to have [Docker Engine](/get-docker.md)
and [Docker Compose](/compose/install.md) installed on your and [Docker Compose](/compose/install.md) installed on your
platform of choice: Linux, Mac or Windows. platform of choice: Linux, Mac or Windows.

2
compose/gettingstarted.md
View File

@ -11,7 +11,7 @@ understandable even if you're not familiar with it.
## Prerequisites ## Prerequisites
Make sure you have already installed both [Docker Engine](/install/index.md) Make sure you have already installed both [Docker Engine](/get-docker.md)
and [Docker Compose](install.md). You don't need to install Python or Redis, as and [Docker Compose](install.md). You don't need to install Python or Redis, as
both are provided by Docker images. both are provided by Docker images.

4
compose/install.md
View File

@ -16,12 +16,12 @@ have Docker Engine installed either locally or remote, depending on your setup.
included as part of those desktop installs. included as part of those desktop installs.
- On Linux systems, first install the - On Linux systems, first install the
[Docker](/install/index.md#server){: target="_blank" class="_"} [Docker Engine](/engine/install/index.md#server){: target="_blank" class="_"}
for your OS as described on the Get Docker page, then come back here for for your OS as described on the Get Docker page, then come back here for
instructions on installing Compose on instructions on installing Compose on
Linux systems. Linux systems.
- To run Compose as a non-root user, see [Manage Docker as a non-root user](/install/linux/linux-postinstall.md). - To run Compose as a non-root user, see [Manage Docker as a non-root user](/engine/install/linux-postinstall.md).
## Install Compose ## Install Compose

2
config/containers/resource_constraints.md
View File

@ -24,7 +24,7 @@ WARNING: No swap limit support
``` ```
Consult your operating system's documentation for enabling them. Consult your operating system's documentation for enabling them.
[Learn more](/install/linux/linux-postinstall.md#your-kernel-does-not-support-cgroup-swap-limit-capabilities). [Learn more](/engine/install/linux-postinstall.md#your-kernel-does-not-support-cgroup-swap-limit-capabilities).
## Memory ## Memory

4
config/daemon/index.md
View File

@ -34,9 +34,9 @@ not manually by a user. This makes it easier to automatically start Docker when
the machine reboots. the machine reboots.
The command to start Docker depends on your operating system. Check the correct The command to start Docker depends on your operating system. Check the correct
page under [Install Docker](/install/index.md). To configure Docker page under [Install Docker](/engine/install/index.md). To configure Docker
to start automatically at system boot, see to start automatically at system boot, see
[Configure Docker to start on boot](/install/linux/linux-postinstall.md#configure-docker-to-start-on-boot). [Configure Docker to start on boot](/engine/install/linux-postinstall.md#configure-docker-to-start-on-boot).
## Start the daemon manually ## Start the daemon manually

4
config/daemon/systemd.md
View File

@ -34,7 +34,7 @@ do not have `systemctl`, use the `service` command.
### Start automatically at system boot ### Start automatically at system boot
If you want Docker to start at boot, see If you want Docker to start at boot, see
[Configure Docker to start on boot](/install/linux/linux-postinstall.md#configure-docker-to-start-on-boot). [Configure Docker to start on boot](/engine/install/linux-postinstall.md#configure-docker-to-start-on-boot).
## Custom Docker daemon options ## Custom Docker daemon options
@ -155,7 +155,7 @@ you need to add this configuration in the Docker systemd service file.
## Configure where the Docker daemon listens for connections ## Configure where the Docker daemon listens for connections
See See
[Configure where the Docker daemon listens for connections](/install/linux/linux-postinstall.md#control-where-the-docker-daemon-listens-for-connections). [Configure where the Docker daemon listens for connections](/engine/install/linux-postinstall.md#control-where-the-docker-daemon-listens-for-connections).
## Manually create the systemd unit files ## Manually create the systemd unit files

2
datacenter/ucp/1.1/installation/system-requirements.md
View File

@ -17,7 +17,7 @@ all nodes must have:
* Linux kernel version 3.10 or higher * Linux kernel version 3.10 or higher
* CS Docker Engine version 1.10 or higher. Learn about the * CS Docker Engine version 1.10 or higher. Learn about the
[operating systems supported by CS Docker Engine](/install/). [operating systems supported by CS Docker Engine](/ee/supported-platforms.md).
* 2.00 GB of RAM * 2.00 GB of RAM
* 3.00 GB of available disk space * 3.00 GB of available disk space
* A static IP address * A static IP address

2
datacenter/ucp/2.2/guides/admin/install/index.md
View File

@ -20,7 +20,7 @@ UCP is a containerized application that requires the commercially supported
Docker Engine to run. Docker Engine to run.
Install Docker Enterprise on each host that you plan to manage with UCP. Install Docker Enterprise on each host that you plan to manage with UCP.
View the [supported platforms](/install/index.md#supported-platforms) View the [supported platforms](/ee/supported-platforms.md)
and click on your platform to get platform-specific instructions for installing and click on your platform to get platform-specific instructions for installing
Docker Enterprise. Docker Enterprise.

2
datacenter/ucp/2.2/guides/admin/install/system-requirements.md
View File

@ -11,7 +11,7 @@ Before installing, be sure your infrastructure has these requirements.
You can install UCP on-premises or on a cloud provider. Common requirements: You can install UCP on-premises or on a cloud provider. Common requirements:
* [Docker Enterprise Edition](/install/index.md) version 17.06 or higher * [Docker Enterprise Edition](/ee/supported-platforms.md) version 17.06 or higher
* Linux kernel version 3.10 or higher * Linux kernel version 3.10 or higher
* A static IP address * A static IP address

2
datacenter/ucp/3.0/guides/admin/install/index.md
View File

@ -20,7 +20,7 @@ UCP is a containerized application that requires the commercially supported
Docker Engine to run. Docker Engine to run.
Install Docker EE on each host that you plan to manage with UCP. Install Docker EE on each host that you plan to manage with UCP.
View the [supported platforms](/install/index.md#supported-platforms) View the [supported platforms](/ee/supported-platforms.md)
and click on your platform to get platform-specific instructions for installing and click on your platform to get platform-specific instructions for installing
Docker EE. Docker EE.

2
datacenter/ucp/3.0/guides/admin/install/system-requirements.md
View File

@ -11,7 +11,7 @@ Before installing, be sure your infrastructure has these requirements.
You can install UCP on-premises or on a cloud provider. Common requirements: You can install UCP on-premises or on a cloud provider. Common requirements:
* [Docker Enterprise Edition](/install/index.md) version 17.06 or higher * [Docker Enterprise Edition](/ee/supported-platforms.md) version 17.06 or higher
* Linux kernel version 3.10 or higher * Linux kernel version 3.10 or higher
* A static IP address * A static IP address

4
docker-for-mac/install.md
View File

@ -48,8 +48,8 @@ Your Mac must meet the following requirements to successfully install Docker Des
## What's included in the installer ## What's included in the installer
The Docker Desktop installation includes The Docker Desktop installation includes
[Docker Engine](/install/), Docker CLI client, [Docker Engine](/engine/index.md), Docker CLI client,
[Docker Compose](/compose/), [Notary](/notary/getting_started/), [Kubernetes](https://github.com/kubernetes/kubernetes/), and [Credential Helper](https://github.com/docker/docker-credential-helpers/). [Docker Compose](/compose/index.md), [Notary](/notary/getting_started/), [Kubernetes](https://github.com/kubernetes/kubernetes/), and [Credential Helper](https://github.com/docker/docker-credential-helpers/).
## Install and run Docker Desktop on Mac ## Install and run Docker Desktop on Mac

6
docker-for-windows/install.md
View File

@ -39,7 +39,11 @@ used side-by-side with Docker Desktop. However, you can still use
### What's included in the installer ### What's included in the installer
The Docker Desktop installation includes [Docker Engine](/install/), Docker CLI client, [Docker Compose](/compose/overview.md), [Notary](/notary/getting_started/), [Kubernetes](https://github.com/kubernetes/kubernetes/), and [Credential Helper](https://github.com/docker/docker-credential-helpers/). The Docker Desktop installation includes [Docker Engine](/engine/index.md),
Docker CLI client, [Docker Compose](/compose/index.md),
[Notary](/notary/getting_started.md),
[Kubernetes](https://github.com/kubernetes/kubernetes/),
and [Credential Helper](https://github.com/docker/docker-credential-helpers/).
Containers and images created with Docker Desktop are shared between all Containers and images created with Docker Desktop are shared between all
user accounts on machines where it is installed. This is because all Windows user accounts on machines where it is installed. This is because all Windows

9
ee/docker-ee/centos.md
View File

@ -28,7 +28,8 @@ on {{ linux-dist-long }}:
Shared between centOS.md, rhel.md, oracle.md Shared between centOS.md, rhel.md, oracle.md
---> --->
For Docker Community Edition on {{ linux-dist-cap }}, see [Get Docker Engine - Community for CentOS](/install/linux/docker-ce/centos.md). For Docker Community Edition on {{ linux-dist-cap }}, see
[Install Docker Engine on CentOS](/engine/install/centos.md).
## Prerequisites ## Prerequisites
@ -219,7 +220,7 @@ Shared between centOS.md, oracle.md
``` ```
Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See
[Linux postinstall](/install/linux/linux-postinstall.md){: target="_blank" class="_" } to allow [Linux postinstall](/engine/install/linux-postinstall.md){: target="_blank" class="_" } to allow
non-privileged users to run Docker commands. non-privileged users to run Docker commands.
<!--- <!---
@ -281,7 +282,7 @@ Not shared
``` ```
Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See
[Linux postinstall](/install/linux/linux-postinstall.md){: target="_blank" class="_" } to allow [Linux postinstall](/engine/install/linux-postinstall.md){: target="_blank" class="_" } to allow
non-privileged users to run Docker commands. non-privileged users to run Docker commands.
<!--- <!---
@ -332,6 +333,6 @@ Shared between centOS.md, rhel.md, oracle.md
## Next steps ## Next steps
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md){: target="_blank" class="_" } - Continue to [Post-installation steps for Linux](/engine/install/linux-postinstall.md){: target="_blank" class="_" }
- Continue with user guides on [Universal Control Plane (UCP)](/ee/ucp/){: target="_blank" class="_" } and [Docker Trusted Registry (DTR)](/ee/dtr/){: target="_blank" class="_" } - Continue with user guides on [Universal Control Plane (UCP)](/ee/ucp/){: target="_blank" class="_" } and [Docker Trusted Registry (DTR)](/ee/dtr/){: target="_blank" class="_" }

6
ee/docker-ee/oracle.md
View File

@ -215,7 +215,7 @@ Shared between centOS.md, oracle.md
``` ```
Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See
[Linux postinstall](/install/linux/linux-postinstall.md){: target="_blank" class="_" } to allow [Linux postinstall](/engine/install/linux-postinstall.md){: target="_blank" class="_" } to allow
non-privileged users to run Docker commands. non-privileged users to run Docker commands.
<!--- <!---
@ -281,7 +281,7 @@ Not shared
``` ```
Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See
[Linux postinstall](/install/linux/linux-postinstall.md){: target="_blank" class="_" } to allow [Linux postinstall](/engine/install/linux-postinstall.md){: target="_blank" class="_" } to allow
non-privileged users to run Docker commands. non-privileged users to run Docker commands.
<!--- <!---
@ -332,6 +332,6 @@ Shared between centOS.md, rhel.md, oracle.md
## Next steps ## Next steps
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md){: target="_blank" class="_" } - Continue to [Post-installation steps for Linux](/engine/install/linux-postinstall.md){: target="_blank" class="_" }
- Continue with user guides on [Universal Control Plane (UCP)](/ee/ucp/){: target="_blank" class="_" } and [Docker Trusted Registry (DTR)](/ee/dtr/){: target="_blank" class="_" } - Continue with user guides on [Universal Control Plane (UCP)](/ee/ucp/){: target="_blank" class="_" } and [Docker Trusted Registry (DTR)](/ee/dtr/){: target="_blank" class="_" }

4
ee/docker-ee/release-notes.md
View File

@ -765,8 +765,8 @@ Update your configuration if this command prints a non-empty value for `MountFla
### New features for Docker Engine EE ### New features for Docker Engine EE
* [FIPS Compliance added for Windows Server 2016 and later](/install/windows/docker-ee) * [FIPS Compliance added for Windows Server 2016 and later](/ee/docker-ee/windows/docker-ee.md)
* [Docker Content Trust Enforcement](/engine/security/trust/content_trust) for the Enterprise Engine. This allows the Docker Engine - Enterprise to run containers not signed by a specific organization. * [Docker Content Trust Enforcement](/engine/security/trust/content_trust.md) for the Enterprise Engine. This allows the Docker Engine - Enterprise to run containers not signed by a specific organization.
### New features ### New features

8
ee/docker-ee/rhel.md
View File

@ -396,7 +396,7 @@ Shared between centOS.md, rhel.md, oracle.md
``` ```
Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See
[Linux postinstall](/install/linux/linux-postinstall.md){: target="_blank" class="_" } to allow [Linux postinstall](/engine/install/linux-postinstall.md){: target="_blank" class="_" } to allow
non-privileged users to run Docker commands. non-privileged users to run Docker commands.
<!--- <!---
@ -479,7 +479,7 @@ Shared between centOS.md, rhel.md, oracle.md
``` ```
Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See
[Linux postinstall](/install/linux/linux-postinstall.md){: target="_blank" class="_" } to allow [Linux postinstall](/engine/install/linux-postinstall.md){: target="_blank" class="_" } to allow
non-privileged users to run Docker commands. non-privileged users to run Docker commands.
</div> </div>
@ -522,7 +522,7 @@ Shared between centOS.md, rhel.md, oracle.md
``` ```
Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See Docker Engine - Enterprise is installed and running. Use `sudo` to run Docker commands. See
[Linux postinstall](/install/linux/linux-postinstall.md){: target="_blank" class="_" } to allow [Linux postinstall](/engine/install/linux-postinstall.md){: target="_blank" class="_" } to allow
non-privileged users to run Docker commands. non-privileged users to run Docker commands.
</div> </div>
@ -572,6 +572,6 @@ Shared between centOS.md, rhel.md, oracle.md
## Next steps ## Next steps
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md){: target="_blank" class="_" } - Continue to [Post-installation steps for Linux](/engine/install/linux-postinstall.md){: target="_blank" class="_" }
- Continue with user guides on [Universal Control Plane (UCP)](/ee/ucp/){: target="_blank" class="_" } and [Docker Trusted Registry (DTR)](/ee/dtr/){: target="_blank" class="_" } - Continue with user guides on [Universal Control Plane (UCP)](/ee/ucp/){: target="_blank" class="_" } and [Docker Trusted Registry (DTR)](/ee/dtr/){: target="_blank" class="_" }

6
ee/docker-ee/suse.md
View File

@ -311,7 +311,7 @@ and update Docker from the repository.
container runs, it prints an informational message and exits. container runs, it prints an informational message and exits.
Docker Engine - Enterprise is installed and running. You need to use `sudo` to Docker Engine - Enterprise is installed and running. You need to use `sudo` to
run Docker commands. Continue to [Linux postinstall](/install/linux/linux-postinstall.md) run Docker commands. Continue to [Linux postinstall](/engine/install/linux-postinstall.md)
to configure the graph storage driver, allow non-privileged users to run Docker to configure the graph storage driver, allow non-privileged users to run Docker
commands, and for other optional configuration steps. commands, and for other optional configuration steps.
@ -391,7 +391,7 @@ manually. You need to download a new file each time you want to upgrade Docker.
container runs, it prints an informational message and exits. container runs, it prints an informational message and exits.
Docker Engine - Enterprise is installed and running. You need to use `sudo` to Docker Engine - Enterprise is installed and running. You need to use `sudo` to
run Docker commands. Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md) run Docker commands. Continue to [Post-installation steps for Linux](/engine/install/linux-postinstall.md)
to allow non-privileged users to run Docker commands and for other optional to allow non-privileged users to run Docker commands and for other optional
configuration steps. configuration steps.
@ -427,6 +427,6 @@ You must delete any edited configuration files manually.
## Next steps ## Next steps
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md) - Continue to [Post-installation steps for Linux](/engine/install/linux-postinstall.md)
- Continue with the [User Guide](/engine/userguide/index.md). - Continue with the [User Guide](/engine/userguide/index.md).

8
ee/docker-ee/ubuntu.md
View File

@ -16,7 +16,7 @@ toc_max: 4
> **Important** > **Important**
> >
> Docker Engine - Community users should go to > Docker Engine - Community users should go to
[Get Docker Engine - Community for Ubuntu](/install/linux/docker-ce/ubuntu.md) [Get Docker Engine - Community for Ubuntu](/engine/install/ubuntu.md)
**instead of this topic**. **instead of this topic**.
{: .important} {: .important}
@ -203,7 +203,7 @@ Naturally, to install Docker Engine - Enterprise on a new host machine using the
Docker Engine - Enterprise is installed and running. The `docker` group is Docker Engine - Enterprise is installed and running. The `docker` group is
created but no users are added to it. You need to use `sudo` to run Docker created but no users are added to it. You need to use `sudo` to run Docker
commands. Continue to [Linux postinstall](/install/linux/linux-postinstall.md) commands. Continue to [Linux postinstall](/engine/install/linux-postinstall.md)
to allow non-privileged users to run Docker commands and for other optional to allow non-privileged users to run Docker commands and for other optional
configuration steps. configuration steps.
@ -265,7 +265,7 @@ Engine - Enterprise.
Docker Engine - Enterprise is installed and running. The `docker` group is Docker Engine - Enterprise is installed and running. The `docker` group is
created but no users are added to it. You need to use `sudo` to run Docker created but no users are added to it. You need to use `sudo` to run Docker
commands. Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md) commands. Continue to [Post-installation steps for Linux](/engine/install/linux-postinstall.md)
to allow non-privileged users to run Docker commands and for other optional to allow non-privileged users to run Docker commands and for other optional
configuration steps. configuration steps.
@ -295,5 +295,5 @@ You must delete any edited configuration files manually.
## Next steps ## Next steps
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md). - Continue to [Post-installation steps for Linux](/engine/install/linux-postinstall.md).
- Continue with the [User Guide](/engine/userguide/index.md). - Continue with the [User Guide](/engine/userguide/index.md).

6
ee/supported-platforms.md
View File

@ -104,6 +104,6 @@ details on EOL of minor and major versions of Docker Enterprise.
## Where to go next ## Where to go next
- [Install Docker Engine - Enterprise for RHEL](/install/linux/docker-ee/rhel/) - [Install Docker Engine - Enterprise for RHEL](/ee/docker-ee/rhel.md)
- [Install Docker Engine - Enterprise for Ubuntu](/install/linux/docker-ee/ubuntu/) - [Install Docker Engine - Enterprise for Ubuntu](/ee/docker-ee/ubuntu/)
- [Install Docker Engine - Enterprise for Windows Server](/install/windows/docker-ee/) - [Install Docker Engine - Enterprise for Windows Server](/ee/docker-ee/windows/docker-ee.md)

12
ee/upgrade.md
View File

@ -216,12 +216,12 @@ $ docker node update --availability drain <node>
To upgrade a node individually by operating system, please follow the instructions To upgrade a node individually by operating system, please follow the instructions
listed below: listed below:
* [Windows Server](/install/windows/docker-ee/#update-docker-engine---enterprise) * [Windows Server](/ee/docker-ee/windows/docker-ee.md#update-docker-engine---enterprise)
* [Ubuntu](/install/linux/docker-ee/ubuntu.md#upgrade-docker-engine---enterprise) * [Ubuntu](/ee/docker-ee/ubuntu.md#upgrade-docker-engine---enterprise)
* [RHEL](/install/linux/docker-ee/rhel/#upgrade-from-the-repository) * [RHEL](/ee/docker-ee/rhel.md#upgrade-from-the-repository)
* [CentOS](/install/linux/docker-ee/centos/#upgrade-from-the-repository) * [CentOS](/ee/docker-ee/centos.md#upgrade-from-the-repository)
* [Oracle Linux](/install/linux/docker-ee/oracle/#upgrade-from-the-repository) * [Oracle Linux](/ee//oracle.md#upgrade-from-the-repository)
* [SLES](/install/linux/docker-ee/suse/#upgrade-docker-engine---enterprise) * [SLES](/ee/docker-ee/suse.md#upgrade-docker-engine---enterprise)
### Post-Upgrade steps for Docker Engine - Enterprise ### Post-Upgrade steps for Docker Engine - Enterprise

2
engine/api/sdk/examples.md
View File

@ -10,7 +10,7 @@ redirect_from:
--- ---
After you After you
[install Docker](/install/index.md), you can [install Docker](/get-docker.md), you can
[install the Go or Python SDK](/engine/api/sdk/index.md#install-the-sdks) and [install the Go or Python SDK](/engine/api/sdk/index.md#install-the-sdks) and
also try out the Docker Engine API. also try out the Docker Engine API.

2
engine/examples/apt-cacher-ng.md
View File

@ -6,7 +6,7 @@ title: Dockerize an apt-cacher-ng service
> **Note**: > **Note**:
> - **If you don't like sudo** then see > - **If you don't like sudo** then see
> [*Giving non-root access*](/install/linux/linux-postinstall.md#manage-docker-as-a-non-root-user). > [*Giving non-root access*](/engine/install/linux-postinstall.md#manage-docker-as-a-non-root-user).
> - **If you're using macOS or docker via TCP** then you shouldn't use sudo. > - **If you're using macOS or docker via TCP** then you shouldn't use sudo.
When you have multiple Docker servers, or build unrelated Docker When you have multiple Docker servers, or build unrelated Docker

2
engine/examples/couchdb_data_volumes.md
View File

@ -5,7 +5,7 @@ title: Dockerize a CouchDB service
--- ---
> **Note**: > **Note**:
> - **If you don't like sudo** then see [*Giving non-root access*](/install/linux/linux-postinstall.md#manage-docker-as-a-non-root-user) > - **If you don't like sudo** then see [*Giving non-root access*](/engine/install/linux-postinstall.md#manage-docker-as-a-non-root-user)
Here's an example of using data volumes to share the same data between Here's an example of using data volumes to share the same data between
two CouchDB containers. This could be used for hot upgrades, testing two CouchDB containers. This could be used for hot upgrades, testing

4
engine/index.md
View File

@ -4,6 +4,8 @@ keywords: Engine
redirect_from: redirect_from:
- /engine/misc/ - /engine/misc/
- /engine/ce-ee-node-activate/ - /engine/ce-ee-node-activate/
- /linux/
- /edge/
title: About Docker Engine title: About Docker Engine
--- ---
@ -92,7 +94,7 @@ implementation, check out the [Docker User Guide](userguide/index.md).
## Release notes ## Release notes
A summary of the changes in each release in the current series can now be found A summary of the changes in each release in the current series can now be found
on the separate [Release Notes page](/release-notes) on the separate [Release Notes page](release-notes/index.md)
## Feature Deprecation Policy ## Feature Deprecation Policy

11
install/linux/docker-ce/binaries.md → engine/install/binaries.md
View File

@ -1,10 +1,11 @@
--- ---
description: Instructions for installing Docker as a binary. Mostly meant for hackers who want to try out Docker on a variety of environments. description: Instructions for installing Docker as a binary. Mostly meant for hackers who want to try out Docker on a variety of environments.
keywords: binaries, installation, docker, documentation, linux keywords: binaries, installation, docker, documentation, linux
title: Install Docker Engine - Community from binaries title: Install Docker Engine from binaries
redirect_from: redirect_from:
- /engine/installation/binaries/ - /engine/installation/binaries/
- /engine/installation/linux/docker-ce/binaries/ - /engine/installation/linux/docker-ce/binaries/
- /install/linux/docker-ce/binaries/
--- ---
> **Note**: You may have been redirected to this page because there is no longer > **Note**: You may have been redirected to this page because there is no longer
@ -79,7 +80,7 @@ instructions for enabling and configuring AppArmor or SELinux.
[https://download.docker.com/linux/static/stable/](https://download.docker.com/linux/static/stable/) [https://download.docker.com/linux/static/stable/](https://download.docker.com/linux/static/stable/)
(or change `stable` to `nightly` or `test`), (or change `stable` to `nightly` or `test`),
choose your hardware platform, and download the `.tgz` file relating to the choose your hardware platform, and download the `.tgz` file relating to the
version of Docker Engine - Community you want to install. version of Docker Engine you want to install.
2. Extract the archive using the `tar` utility. The `dockerd` and `docker` 2. Extract the archive using the `tar` utility. The `dockerd` and `docker`
binaries are extracted. binaries are extracted.
@ -124,7 +125,7 @@ The macOS binary includes the Docker client only. It does not include the
1. Download the static binary archive. Go to 1. Download the static binary archive. Go to
[https://download.docker.com/mac/static/stable/x86_64/](https://download.docker.com/mac/static/stable/x86_64/), [https://download.docker.com/mac/static/stable/x86_64/](https://download.docker.com/mac/static/stable/x86_64/),
(or change `stable` to `nightly` or `test`), (or change `stable` to `nightly` or `test`),
and download the `.tgz` file relating to the version of Docker Engine - Community you want and download the `.tgz` file relating to the version of Docker Engine you want
to install. to install.
2. Extract the archive using the `tar` utility. The `docker` binary is 2. Extract the archive using the `tar` utility. The `docker` binary is
@ -155,13 +156,13 @@ The macOS binary includes the Docker client only. It does not include the
## Upgrade static binaries ## Upgrade static binaries
To upgrade your manual installation of Docker Engine - Community, first stop any To upgrade your manual installation of Docker Engine, first stop any
`dockerd` or `dockerd.exe` processes running locally, then follow the `dockerd` or `dockerd.exe` processes running locally, then follow the
regular installation steps to install the new version on top of the existing regular installation steps to install the new version on top of the existing
version. version.
## Next steps ## Next steps
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md). - Continue to [Post-installation steps for Linux](linux-postinstall.md).
- Take a look at the [Get started](/get-started/index.md) training modules to learn how to build an image and run it as a containerized application. - Take a look at the [Get started](/get-started/index.md) training modules to learn how to build an image and run it as a containerized application.
- Review the topics in [Develop with Docker](/develop/index.md) to learn how to build new applications using Docker. - Review the topics in [Develop with Docker](/develop/index.md) to learn how to build new applications using Docker.

90
install/linux/docker-ce/centos.md → engine/install/centos.md
View File

@ -1,24 +1,25 @@
--- ---
description: Instructions for installing Docker Engine - Community on CentOS description: Instructions for installing Docker Engine on CentOS
keywords: requirements, apt, installation, centos, rpm, install, uninstall, upgrade, update keywords: requirements, apt, installation, centos, rpm, install, uninstall, upgrade, update
redirect_from: redirect_from:
- /engine/installation/centos/ - /engine/installation/centos/
- /engine/installation/linux/docker-ce/centos/ - /engine/installation/linux/docker-ce/centos/
- /install/linux/centos/ - /install/linux/centos/
- /install/linux/docker-ce/centos/
- /engine/installation/linux/centos/ - /engine/installation/linux/centos/
title: Get Docker Engine - Community for CentOS title: Install Docker Engine on CentOS
toc_max: 4 toc_max: 4
--- ---
To get started with Docker Engine - Community on CentOS, make sure you To get started with Docker Engine on CentOS, make sure you
[meet the prerequisites](#prerequisites), then [meet the prerequisites](#prerequisites), then
[install Docker](#install-docker-ce). [install Docker](#installation-methods).
## Prerequisites ## Prerequisites
### OS requirements ### OS requirements
To install Docker Engine - Community, you need a maintained version of CentOS 7. Archived To install Docker Engine, you need a maintained version of CentOS 7. Archived
versions aren't supported or tested. versions aren't supported or tested.
The `centos-extras` repository must be enabled. This repository is enabled by The `centos-extras` repository must be enabled. This repository is enabled by
@ -46,11 +47,11 @@ $ sudo yum remove docker \
It's OK if `yum` reports that none of these packages are installed. It's OK if `yum` reports that none of these packages are installed.
The contents of `/var/lib/docker/`, including images, containers, volumes, and The contents of `/var/lib/docker/`, including images, containers, volumes, and
networks, are preserved. The Docker Engine - Community package is now called `docker-ce`. networks, are preserved. The Docker Engine package is now called `docker-ce`.
## Install Docker Engine - Community ## Installation methods
You can install Docker Engine - Community in different ways, depending on your needs: You can install Docker Engine in different ways, depending on your needs:
- Most users - Most users
[set up Docker's repositories](#install-using-the-repository) and install [set up Docker's repositories](#install-using-the-repository) and install
@ -67,7 +68,7 @@ You can install Docker Engine - Community in different ways, depending on your n
### Install using the repository ### Install using the repository
Before you install Docker Engine - Community for the first time on a new host machine, you need Before you install Docker Engine for the first time on a new host machine, you need
to set up the Docker repository. Afterward, you can install and update Docker to set up the Docker repository. Afterward, you can install and update Docker
from the repository. from the repository.
@ -75,23 +76,16 @@ from the repository.
{% assign download-url-base = "https://download.docker.com/linux/centos" %} {% assign download-url-base = "https://download.docker.com/linux/centos" %}
1. Install required packages. `yum-utils` provides the `yum-config-manager` Install the `yum-utils` package (which provides the `yum-config-manager`
utility, and `device-mapper-persistent-data` and `lvm2` are required by the utility) and set up the **stable** repository.
`devicemapper` storage driver.
```bash ```bash
$ sudo yum install -y yum-utils \ $ sudo yum install -y yum-utils
device-mapper-persistent-data \
lvm2
```
2. Use the following command to set up the **stable** repository. $ sudo yum-config-manager \
--add-repo \
```bash {{ download-url-base }}/docker-ce.repo
$ sudo yum-config-manager \ ```
--add-repo \
{{ download-url-base }}/docker-ce.repo
```
> **Optional**: Enable the **nightly** or **test** repositories. > **Optional**: Enable the **nightly** or **test** repositories.
> >
@ -117,11 +111,11 @@ from the repository.
> $ sudo yum-config-manager --disable docker-ce-nightly > $ sudo yum-config-manager --disable docker-ce-nightly
> ``` > ```
> >
> [Learn about **nightly** and **test** channels](/install/index.md). > [Learn about **nightly** and **test** channels](index.md).
#### Install Docker Engine - Community #### Install Docker Engine
1. Install the _latest version_ of Docker Engine - Community and containerd, or go to the next step to install a specific version: 1. Install the _latest version_ of Docker Engine and containerd, or go to the next step to install a specific version:
```bash ```bash
$ sudo yum install docker-ce docker-ce-cli containerd.io $ sudo yum install docker-ce docker-ce-cli containerd.io
@ -139,7 +133,7 @@ from the repository.
Docker is installed but not started. The `docker` group is created, but no users are added to the group. Docker is installed but not started. The `docker` group is created, but no users are added to the group.
2. To install a _specific version_ of Docker Engine - Community, list the available versions 2. To install a _specific version_ of Docker Engine, list the available versions
in the repo, then select and install: in the repo, then select and install:
a. List and sort the versions available in your repo. This example sorts a. List and sort the versions available in your repo. This example sorts
@ -174,7 +168,7 @@ from the repository.
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
4. Verify that Docker Engine - Community is installed correctly by running the `hello-world` 4. Verify that Docker Engine is installed correctly by running the `hello-world`
image. image.
```bash ```bash
@ -184,31 +178,31 @@ from the repository.
This command downloads a test image and runs it in a container. When the This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits. container runs, it prints an informational message and exits.
Docker Engine - Community is installed and running. You need to use `sudo` to run Docker Docker Engine is installed and running. You need to use `sudo` to run Docker
commands. Continue to [Linux postinstall](/install/linux/linux-postinstall.md) to allow commands. Continue to [Linux postinstall](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration non-privileged users to run Docker commands and for other optional configuration
steps. steps.
#### Upgrade Docker Engine - Community #### Upgrade Docker Engine
To upgrade Docker Engine - Community, follow the [installation instructions](#install-docker-ce), To upgrade Docker Engine, follow the [installation instructions](#install-using-the-repository),
choosing the new version you want to install. choosing the new version you want to install.
### Install from a package ### Install from a package
If you cannot use Docker's repository to install Docker, you can download the If you cannot use Docker's repository to install Docker, you can download the
`.rpm` file for your release and install it manually. You need to download `.rpm` file for your release and install it manually. You need to download
a new file each time you want to upgrade Docker Engine - Community. a new file each time you want to upgrade Docker Engine.
1. Go to 1. Go to [{{ download-url-base }}/]({{ download-url-base }}/){: target="_blank" class="_" }
[{{ download-url-base }}/7/x86_64/stable/Packages/]({{ download-url-base }}/7/x86_64/stable/Packages/) and choose your version of CentOS. Then browse to `x86_64/stable/Packages/`
and download the `.rpm` file for the Docker version you want to install. and download the `.rpm` file for the Docker version you want to install.
> **Note**: To install a **nightly** or **test** (pre-release) package, > **Note**: To install a **nightly** or **test** (pre-release) package,
> change the word `stable` in the above URL to `nightly` or `test`. > change the word `stable` in the above URL to `nightly` or `test`.
> [Learn about **nightly** and **test** channels](/install/index.md). > [Learn about **nightly** and **test** channels](index.md).
2. Install Docker Engine - Community, changing the path below to the path where you downloaded 2. Install Docker Engine, changing the path below to the path where you downloaded
the Docker package. the Docker package.
```bash ```bash
@ -224,7 +218,7 @@ a new file each time you want to upgrade Docker Engine - Community.
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
4. Verify that Docker Engine - Community is installed correctly by running the `hello-world` 4. Verify that Docker Engine is installed correctly by running the `hello-world`
image. image.
```bash ```bash
@ -234,25 +228,25 @@ a new file each time you want to upgrade Docker Engine - Community.
This command downloads a test image and runs it in a container. When the This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits. container runs, it prints an informational message and exits.
Docker Engine - Community is installed and running. You need to use `sudo` to run Docker commands. Docker Engine is installed and running. You need to use `sudo` to run Docker commands.
Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md) to allow Continue to [Post-installation steps for Linux](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration non-privileged users to run Docker commands and for other optional configuration
steps. steps.
#### Upgrade Docker Engine - Community #### Upgrade Docker Engine
To upgrade Docker Engine - Community, download the newer package file and repeat the To upgrade Docker Engine, download the newer package file and repeat the
[installation procedure](#install-from-a-package), using `yum -y upgrade` [installation procedure](#install-from-a-package), using `yum -y upgrade`
instead of `yum -y install`, and pointing to the new file. instead of `yum -y install`, and pointing to the new file.
{% include install-script.md %} {% include install-script.md %}
## Uninstall Docker Engine - Community ## Uninstall Docker Engine
1. Uninstall the Docker package: 1. Uninstall the Docker Engine, CLI, and Containerd packages:
```bash ```bash
$ sudo yum remove docker-ce $ sudo yum remove docker-ce docker-ce-cli containerd.io
``` ```
2. Images, containers, volumes, or customized configuration files on your host 2. Images, containers, volumes, or customized configuration files on your host
@ -267,5 +261,5 @@ You must delete any edited configuration files manually.
## Next steps ## Next steps
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md). - Continue to [Post-installation steps for Linux](linux-postinstall.md).
- Review the topics in [Develop with Docker](/develop/index.md) to learn how to build new applications using Docker. - Review the topics in [Develop with Docker](/develop/index.md) to learn how to build new applications using Docker.

101
install/linux/docker-ce/debian.md → engine/install/debian.md
View File

@ -1,31 +1,31 @@
--- ---
description: Instructions for installing Docker Engine - Community on Debian description: Instructions for installing Docker Engine on Debian
keywords: requirements, apt, installation, debian, install, uninstall, upgrade, update keywords: requirements, apt, installation, debian, install, uninstall, upgrade, update
redirect_from: redirect_from:
- /engine/installation/debian/ - /engine/installation/debian/
- /engine/installation/linux/raspbian/ - /engine/installation/linux/raspbian/
- /engine/installation/linux/debian/ - /engine/installation/linux/debian/
- /engine/installation/linux/docker-ce/debian/ - /engine/installation/linux/docker-ce/debian/
title: Get Docker Engine - Community for Debian - /install/linux/docker-ce/debian/
title: Install Docker Engine on Debian
toc_max: 4 toc_max: 4
--- ---
To get started with Docker Engine - Community on Debian, make sure you To get started with Docker Engine on Debian, make sure you
[meet the prerequisites](#prerequisites), then [meet the prerequisites](#prerequisites), then
[install Docker](#install-docker-ce). [install Docker](#installation-methods).
## Prerequisites ## Prerequisites
### OS requirements ### OS requirements
To install Docker Engine - Community, you need the 64-bit version of one of these Debian or To install Docker Engine, you need the 64-bit version of one of these Debian or
Raspbian versions: Raspbian versions:
- Buster 10 (stable) - Buster 10 (stable)
- Stretch 9 / Raspbian Stretch - Stretch 9 / Raspbian Stretch
Docker Engine - Community is supported on `x86_64` (or `amd64`), `armhf`, and `arm64` architectures. Docker Engine is supported on `x86_64` (or `amd64`), `armhf`, and `arm64` architectures.
### Uninstall old versions ### Uninstall old versions
@ -39,11 +39,11 @@ $ sudo apt-get remove docker docker-engine docker.io containerd runc
It's OK if `apt-get` reports that none of these packages are installed. It's OK if `apt-get` reports that none of these packages are installed.
The contents of `/var/lib/docker/`, including images, containers, volumes, and The contents of `/var/lib/docker/`, including images, containers, volumes, and
networks, are preserved. The Docker Engine - Community package is now called `docker-ce`. networks, are preserved. The Docker Engine package is now called `docker-ce`.
## Install Docker Engine - Community ## Installation methods
You can install Docker Engine - Community in different ways, depending on your needs: You can install Docker Engine in different ways, depending on your needs:
- Most users - Most users
[set up Docker's repositories](#install-using-the-repository) and install [set up Docker's repositories](#install-using-the-repository) and install
@ -61,7 +61,7 @@ You can install Docker Engine - Community in different ways, depending on your n
### Install using the repository ### Install using the repository
Before you install Docker Engine - Community for the first time on a new host machine, you need Before you install Docker Engine for the first time on a new host machine, you need
to set up the Docker repository. Afterward, you can install and update Docker to set up the Docker repository. Afterward, you can install and update Docker
from the repository. from the repository.
@ -74,15 +74,12 @@ from the repository.
{% assign download-url-base = "https://download.docker.com/linux/debian" %} {% assign download-url-base = "https://download.docker.com/linux/debian" %}
1. Update the `apt` package index: 1. Update the `apt` package index and install packages to allow `apt` to use a
repository over HTTPS:
```bash ```bash
$ sudo apt-get update $ sudo apt-get update
```
2. Install packages to allow `apt` to use a repository over HTTPS:
```bash
$ sudo apt-get install \ $ sudo apt-get install \
apt-transport-https \ apt-transport-https \
ca-certificates \ ca-certificates \
@ -91,7 +88,7 @@ from the repository.
software-properties-common software-properties-common
``` ```
3. Add Docker's official GPG key: 2. Add Docker's official GPG key:
```bash ```bash
$ curl -fsSL {{ download-url-base }}/gpg | sudo apt-key add - $ curl -fsSL {{ download-url-base }}/gpg | sudo apt-key add -
@ -110,9 +107,9 @@ from the repository.
sub 4096R/F273FCD8 2017-02-22 sub 4096R/F273FCD8 2017-02-22
``` ```
4. Use the following command to set up the **stable** repository. To add the 3. Use the following command to set up the **stable** repository. To add the
**nightly** or **test** repository, add the word `nightly` or `test` (or both) **nightly** or **test** repository, add the word `nightly` or `test` (or both)
after the word `stable` in the commands below. [Learn about **nightly** and **test** channels](/install/index.md). after the word `stable` in the commands below. [Learn about **nightly** and **test** channels](index.md).
> **Note**: The `lsb_release -cs` sub-command below returns the name of your > **Note**: The `lsb_release -cs` sub-command below returns the name of your
> Debian distribution, such as `helium`. Sometimes, in a distribution > Debian distribution, such as `helium`. Sometimes, in a distribution
@ -159,20 +156,16 @@ from the repository.
</div> </div>
</div> <!-- tab-content --> </div> <!-- tab-content -->
#### Install Docker Engine - Community #### Install Docker Engine
> **Note**: This procedure works for Debian on `x86_64` / `amd64`, Debian ARM, > **Note**: This procedure works for Debian on `x86_64` / `amd64`, Debian ARM,
> or Raspbian. > or Raspbian.
1. Update the `apt` package index. 1. Update the `apt` package index, and install the _latest version_ of Docker
Engine and containerd, or go to the next step to install a specific version:
```bash ```bash
$ sudo apt-get update $ sudo apt-get update
```
2. Install the _latest version_ of Docker Engine - Community and containerd, or go to the next step to install a specific version:
```bash
$ sudo apt-get install docker-ce docker-ce-cli containerd.io $ sudo apt-get install docker-ce docker-ce-cli containerd.io
``` ```
@ -183,7 +176,8 @@ from the repository.
> `apt-get update` command always installs the highest possible version, > `apt-get update` command always installs the highest possible version,
> which may not be appropriate for your stability needs. > which may not be appropriate for your stability needs.
3. To install a _specific version_ of Docker Engine - Community, list the available versions in the repo, then select and install: 2. To install a _specific version_ of Docker Engine, list the available versions
in the repo, then select and install:
a. List the versions available in your repo: a. List the versions available in your repo:
@ -204,7 +198,7 @@ from the repository.
$ sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io $ sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io
``` ```
4. Verify that Docker Engine - Community is installed correctly by running the `hello-world` 3. Verify that Docker Engine is installed correctly by running the `hello-world`
image. image.
```bash ```bash
@ -214,34 +208,33 @@ from the repository.
This command downloads a test image and runs it in a container. When the This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits. container runs, it prints an informational message and exits.
Docker Engine - Community is installed and running. The `docker` group is created but no users Docker Engine is installed and running. The `docker` group is created but no users
are added to it. You need to use `sudo` to run Docker commands. are added to it. You need to use `sudo` to run Docker commands.
Continue to [Linux postinstall](/install/linux/linux-postinstall.md) to allow Continue to [Linux postinstall](linux-postinstall.md) to allow non-privileged
non-privileged users to run Docker commands and for other optional configuration users to run Docker commands and for other optional configuration steps.
steps.
#### Upgrade Docker Engine - Community #### Upgrade Docker Engine
To upgrade Docker Engine - Community, first run `sudo apt-get update`, then follow the To upgrade Docker Engine, first run `sudo apt-get update`, then follow the
[installation instructions](#install-docker-ce), choosing the new version you want [installation instructions](#install-using-the-repository), choosing the new
to install. version you want to install.
### Install from a package ### Install from a package
If you cannot use Docker's repository to install Docker Engine - Community, you can download the If you cannot use Docker's repository to install Docker Engine, you can download the
`.deb` file for your release and install it manually. You need to download `.deb` file for your release and install it manually. You need to download
a new file each time you want to upgrade Docker. a new file each time you want to upgrade Docker.
1. Go to [`{{ download-url-base }}/dists/`]({{ download-url-base }}/dists/){: target="_blank" class="_" }, 1. Go to [`{{ download-url-base }}/dists/`]({{ download-url-base }}/dists/){: target="_blank" class="_" },
choose your Debian version, browse to `pool/stable/`, choose `amd64`, choose your Debian version, then browse to `pool/stable/`, choose `amd64`,
`armhf`, or `arm64` and download the `.deb` file for the Docker Engine - Community version `armhf`, or `arm64` and download the `.deb` file for the Docker version
you want to install. you want to install.
> **Note**: To install a **nightly** package, change the word > **Note**: To install a **nightly** or **test** (pre-release) package,
> `stable` in the URL to `nightly`. > change the word `stable` in the above URL to `nightly` or `test`.
> [Learn about **nightly** and **test** channels](/install/index.md). > [Learn about **nightly** and **test** channels](index.md).
2. Install Docker Engine - Community, changing the path below to the path where you downloaded 2. Install Docker Engine, changing the path below to the path where you downloaded
the Docker package. the Docker package.
```bash ```bash
@ -250,7 +243,7 @@ a new file each time you want to upgrade Docker.
The Docker daemon starts automatically. The Docker daemon starts automatically.
3. Verify that Docker Engine - Community is installed correctly by running the `hello-world` 3. Verify that Docker Engine is installed correctly by running the `hello-world`
image. image.
```bash ```bash
@ -260,25 +253,25 @@ a new file each time you want to upgrade Docker.
This command downloads a test image and runs it in a container. When the This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits. container runs, it prints an informational message and exits.
Docker Engine - Community is installed and running. The `docker` group is created but no users Docker Engine is installed and running. The `docker` group is created but no users
are added to it. You need to use `sudo` to run Docker commands. are added to it. You need to use `sudo` to run Docker commands.
Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md) Continue to [Post-installation steps for Linux](linux-postinstall.md) to allow
to allow non-privileged users to run Docker commands and for other optional non-privileged users to run Docker commands and for other optional configuration
configuration steps. steps.
#### Upgrade Docker Engine - Community #### Upgrade Docker Engine
To upgrade Docker Engine - Community, download the newer package file and repeat the To upgrade Docker Engine, download the newer package file and repeat the
[installation procedure](#install-from-a-package), pointing to the new file. [installation procedure](#install-from-a-package), pointing to the new file.
{% include install-script.md %} {% include install-script.md %}
## Uninstall Docker Engine - Community ## Uninstall Docker Engine
1. Uninstall the Docker Engine - Community package: 1. Uninstall the Docker Engine, CLI, and Containerd packages:
```bash ```bash
$ sudo apt-get purge docker-ce $ sudo apt-get purge docker-ce docker-ce-cli containerd.io
``` ```
2. Images, containers, volumes, or customized configuration files on your host 2. Images, containers, volumes, or customized configuration files on your host
@ -293,5 +286,5 @@ You must delete any edited configuration files manually.
## Next steps ## Next steps
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md). - Continue to [Post-installation steps for Linux](linux-postinstall.md).
- Review the topics in [Develop with Docker](/develop/index.md) to learn how to build new applications using Docker. - Review the topics in [Develop with Docker](/develop/index.md) to learn how to build new applications using Docker.

95
install/linux/docker-ce/fedora.md → engine/install/fedora.md
View File

@ -1,27 +1,27 @@
--- ---
description: Instructions for installing Docker Engine - Community on Fedora description: Instructions for installing Docker Engine on Fedora
keywords: requirements, apt, installation, fedora, rpm, install, uninstall, upgrade, update keywords: requirements, apt, installation, fedora, rpm, install, uninstall, upgrade, update
redirect_from: redirect_from:
- /engine/installation/fedora/ - /engine/installation/fedora/
- /engine/installation/linux/fedora/ - /engine/installation/linux/fedora/
- /engine/installation/linux/docker-ce/fedora/ - /engine/installation/linux/docker-ce/fedora/
title: Get Docker Engine - Community for Fedora - /install/linux/docker-ce/fedora/
title: Install Docker Engine on Fedora
toc_max: 4 toc_max: 4
--- ---
To get started with Docker Engine - Community on Fedora, make sure you To get started with Docker Engine on Fedora, make sure you
[meet the prerequisites](#prerequisites), then [meet the prerequisites](#prerequisites), then
[install Docker](#install-docker-ce). [install Docker](#installation-methods).
## Prerequisites ## Prerequisites
### OS requirements ### OS requirements
To install Docker, you need the 64-bit version of one of these Fedora versions: To install Docker Engine, you need the 64-bit version of one of these Fedora versions:
- 30 - Fedora 30
- 31 - Fedora 31
### Uninstall old versions ### Uninstall old versions
@ -44,11 +44,11 @@ $ sudo dnf remove docker \
It's OK if `dnf` reports that none of these packages are installed. It's OK if `dnf` reports that none of these packages are installed.
The contents of `/var/lib/docker/`, including images, containers, volumes, and The contents of `/var/lib/docker/`, including images, containers, volumes, and
networks, are preserved. The Docker Engine - Community package is now called `docker-ce`. networks, are preserved. The Docker Engine package is now called `docker-ce`.
## Install Docker Engine - Community ## Installation methods
You can install Docker Engine - Community in different ways, depending on your needs: You can install Docker Engine in different ways, depending on your needs:
- Most users - Most users
[set up Docker's repositories](#install-using-the-repository) and install [set up Docker's repositories](#install-using-the-repository) and install
@ -65,7 +65,7 @@ You can install Docker Engine - Community in different ways, depending on your n
### Install using the repository ### Install using the repository
Before you install Docker Engine - Community for the first time on a new host machine, you need Before you install Docker Engine for the first time on a new host machine, you need
to set up the Docker repository. Afterward, you can install and update Docker to set up the Docker repository. Afterward, you can install and update Docker
from the repository. from the repository.
@ -73,20 +73,18 @@ from the repository.
{% assign download-url-base = "https://download.docker.com/linux/fedora" %} {% assign download-url-base = "https://download.docker.com/linux/fedora" %}
1. Install the `dnf-plugins-core` package which provides the commands to manage Install the `dnf-plugins-core` package (which provides the commands to manage
your DNF repositories from the command line. your DNF repositories) and set up the **stable** repository.
```bash ```bash
$ sudo dnf -y install dnf-plugins-core $ sudo dnf -y install dnf-plugins-core
```
2. Use the following command to set up the **stable** repository. $ sudo dnf -y install dnf-plugins-core
```bash $ sudo dnf config-manager \
$ sudo dnf config-manager \ --add-repo \
--add-repo \ {{ download-url-base }}/docker-ce.repo
{{ download-url-base }}/docker-ce.repo ```
```
> **Optional**: Enable the **nightly** or **test** repositories. > **Optional**: Enable the **nightly** or **test** repositories.
> >
@ -113,11 +111,11 @@ from the repository.
> $ sudo dnf config-manager --set-disabled docker-ce-nightly > $ sudo dnf config-manager --set-disabled docker-ce-nightly
> ``` > ```
> >
> [Learn about **nightly** and **test** channels](/install/index.md). > [Learn about **nightly** and **test** channels](index.md).
#### Install Docker Engine - Community #### Install Docker Engine
1. Install the _latest version_ of Docker Engine - Community and containerd, or go to the next step to install a specific version: 1. Install the _latest version_ of Docker Engine and containerd, or go to the next step to install a specific version:
```bash ```bash
$ sudo dnf install docker-ce docker-ce-cli containerd.io $ sudo dnf install docker-ce docker-ce-cli containerd.io
@ -135,7 +133,7 @@ from the repository.
Docker is installed but not started. The `docker` group is created, but no users are added to the group. Docker is installed but not started. The `docker` group is created, but no users are added to the group.
2. To install a _specific version_ of Docker Engine - Community, list the available versions 2. To install a _specific version_ of Docker Engine, list the available versions
in the repo, then select and install: in the repo, then select and install:
a. List and sort the versions available in your repo. This example sorts a. List and sort the versions available in your repo. This example sorts
@ -179,7 +177,7 @@ from the repository.
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
5. Verify that Docker Engine - Community is installed correctly by running the `hello-world` 5. Verify that Docker Engine is installed correctly by running the `hello-world`
image. image.
```bash ```bash
@ -189,44 +187,47 @@ from the repository.
This command downloads a test image and runs it in a container. When the This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits. container runs, it prints an informational message and exits.
Docker Engine - Community is installed and running. You need to use `sudo` to run Docker Docker Engine is installed and running. You need to use `sudo` to run Docker
commands. Continue to [Linux postinstall](/install/linux/linux-postinstall.md) to allow commands. Continue to [Linux postinstall](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration non-privileged users to run Docker commands and for other optional configuration
steps. steps.
#### Upgrade Docker Engine - Community #### Upgrade Docker Engine
To upgrade Docker Engine - Community, follow the [installation instructions](#install-docker-ce), To upgrade Docker Engine, follow the [installation instructions](#install-using-the-repository),
choosing the new version you want to install. choosing the new version you want to install.
### Install from a package ### Install from a package
If you cannot use Docker's repository to install Docker, you can download the If you cannot use Docker's repository to install Docker, you can download the
`.rpm` file for your release and install it manually. You need to download `.rpm` file for your release and install it manually. You need to download
a new file each time you want to upgrade Docker Engine - Community. a new file each time you want to upgrade Docker Engine.
1. Go to [{{ download-url-base }}/]({{ download-url-base }}/) and choose your 1. Go to [{{ download-url-base }}/]({{ download-url-base }}/){: target="_blank" class="_" }
version of Fedora. Go to `x86_64/stable/Packages/` and choose your version of Fedora. Then browse to `x86_64/stable/Packages/`
and download the `.rpm` file for the Docker version you want to install. and download the `.rpm` file for the Docker version you want to install.
> **Note**: To install a **nightly** or **test** (pre-release) package, > **Note**: To install a **nightly** or **test** (pre-release) package,
> change the word `stable` in the above URL to `nightly` or `test`. > change the word `stable` in the above URL to `nightly` or `test`.
> [Learn about **nightly** and **test** channels](/install/index.md). > [Learn about **nightly** and **test** channels](index.md).
2. Install Docker Engine - Community, changing the path below to the path where you downloaded 2. Install Docker Engine, changing the path below to the path where you downloaded
the Docker package. the Docker package.
```bash ```bash
$ sudo dnf -y install /path/to/package.rpm $ sudo dnf -y install /path/to/package.rpm
``` ```
Docker is installed but not started. The `docker` group is created, but no
users are added to the group.
3. Start Docker. 3. Start Docker.
```bash ```bash
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
4. Verify that Docker Engine - Community is installed correctly by running the `hello-world` 4. Verify that Docker Engine is installed correctly by running the `hello-world`
image. image.
```bash ```bash
@ -236,25 +237,25 @@ a new file each time you want to upgrade Docker Engine - Community.
This command downloads a test image and runs it in a container. When the This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits. container runs, it prints an informational message and exits.
Docker Engine - Community is installed and running. You need to use `sudo` to run Docker commands. Docker Engine is installed and running. You need to use `sudo` to run Docker commands.
Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md) to allow Continue to [Post-installation steps for Linux](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration non-privileged users to run Docker commands and for other optional configuration
steps. steps.
#### Upgrade Docker Engine - Community #### Upgrade Docker Engine
To upgrade Docker Engine - Community, download the newer package file and repeat the To upgrade Docker Engine, download the newer package file and repeat the
[installation procedure](#install-from-a-package), using `dnf -y upgrade` [installation procedure](#install-from-a-package), using `dnf -y upgrade`
instead of `dnf -y install`, and pointing to the new file. instead of `dnf -y install`, and pointing to the new file.
{% include install-script.md %} {% include install-script.md %}
## Uninstall Docker Engine - Community ## Uninstall Docker Engine
1. Uninstall the Docker package: 1. Uninstall the Docker Engine, CLI, and Containerd packages:
```bash ```bash
$ sudo dnf remove docker-ce $ sudo dnf remove docker-ce docker-ce-cli containerd.io
``` ```
2. Images, containers, volumes, or customized configuration files on your host 2. Images, containers, volumes, or customized configuration files on your host
@ -269,5 +270,5 @@ You must delete any edited configuration files manually.
## Next steps ## Next steps
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md). - Continue to [Post-installation steps for Linux](linux-postinstall.md).
- Review the topics in [Develop with Docker](/develop/index.md) to learn how to build new applications using Docker. - Review the topics in [Develop with Docker](/develop/index.md) to learn how to build new applications using Docker.

43
install/index.md → engine/install/index.md
View File

@ -1,10 +1,8 @@
--- ---
title: Docker Engine overview title: Install Docker Engine
description: Lists the installation methods description: Lists the installation methods
keywords: docker, installation, install, Docker Engine - Community, Docker Engine - Enterprise, docker editions, stable, edge keywords: docker, installation, install, Docker Engine, Docker Engine, docker editions, stable, edge
redirect_from: redirect_from:
- /install/overview/
- /installation/
- /engine/installation/linux/ - /engine/installation/linux/
- /engine/installation/linux/frugalware/ - /engine/installation/linux/frugalware/
- /engine/installation/frugalware/ - /engine/installation/frugalware/
@ -16,8 +14,6 @@ redirect_from:
- /engine/installation/linux/docker-ee/ - /engine/installation/linux/docker-ee/
- /engine/installation/ - /engine/installation/
- /en/latest/installation/ - /en/latest/installation/
- /linux/
- /edge/
toc_max: 2 toc_max: 2
--- ---
@ -44,31 +40,28 @@ For more information, see [Release channels](#release-channels).
## Supported platforms ## Supported platforms
Docker Engine is available on a variety of Linux platforms, [Mac](/docker-for-mac/install/) Docker Engine is available on a variety of Linux platforms, [Mac](/docker-for-mac/install.md)
and [Windows](/docker-for-windows/install/) through Docker Desktop, Windows and [Windows](/docker-for-windows/install.md) through Docker Desktop, Windows
Server, and as a static binary installation. Find your preferred operating Server, and as a static binary installation. Find your preferred operating
system below. system below.
#### Desktop #### Desktop
{% assign green-check = '![yes](/install/images/green-check.svg){: style="height: 14px; margin: 0 auto"}' %} {% assign yes = '![yes](/install/images/green-check.svg){: style="height: 14px; margin: 0 auto"}' %}
| Platform | x86_64 | | Platform | x86_64 / amd64 |
|:----------------------------------------------------------------------------|:-----------------:| |:-------------------------------------------------------------|:-------------------------------------------:|
| [Docker Desktop for Mac (macOS)](/docker-for-mac/install/) | {{ green-check }} | | [Docker Desktop for Mac (macOS)](/docker-for-mac/install.md) | [{{ yes }}](/docker-for-mac/install.md) |
| [Docker Desktop for Windows (Microsoft Windows 10)](/docker-for-windows/install/) | {{ green-check }} | | [Docker Desktop for Windows](/docker-for-windows/install.md) | [{{ yes }}](/docker-for-windows/install.md) |
#### Server #### Server
{% assign green-check = '![yes](/install/images/green-check.svg){: style="height: 14px; margin: 0 auto"}' %} | Platform | x86_64 / amd64 | ARM | ARM64 / AARCH64 | IBM Power (ppc64le) | IBM Z (s390x) |
{% assign install-prefix-ce = '/install/linux/docker-ce' %} |:----------------------|:-----------------------|:-------------------------|:-----------------------|:-----------------------|:-----------------------|
| [CentOS](centos.md) | [{{ yes }}](centos.md) | | [{{ yes }}](centos.md) | | |
| Platform | x86_64 / amd64 | ARM | ARM64 / AARCH64 | IBM Power (ppc64le) | IBM Z (s390x) | | [Debian](debian.md) | [{{ yes }}](debian.md) | [{{ yes }}](debian.md) | [{{ yes }}](debian.md) | | |
|:--------------------------------------------|:-------------------------------------------------------|:-------------------------------------------------------|:-------------------------------------------------------|:-------------------------------------------------------|:-------------------------------------------------------| | [Fedora](fedora.md) | [{{ yes }}](fedora.md) | | [{{ yes }}](fedora.md) | | |
| [CentOS]({{ install-prefix-ce }}/centos/) | [{{ green-check }}]({{ install-prefix-ce }}/centos/) | | [{{ green-check }}]({{ install-prefix-ce }}/centos/) | | | | [Ubuntu](ubuntu.md) | [{{ yes }}](ubuntu.md) | [{{ yes }}](ubuntu.md) | [{{ yes }}](ubuntu.md) | [{{ yes }}](ubuntu.md) | [{{ yes }}](ubuntu.md) |
| [Debian]({{ install-prefix-ce }}/debian/) | [{{ green-check }}]({{ install-prefix-ce }}/debian/) | [{{ green-check }}]({{ install-prefix-ce }}/debian/) | [{{ green-check }}]({{ install-prefix-ce }}/debian/) | | |
| [Fedora]({{ install-prefix-ce }}/fedora/) | [{{ green-check }}]({{ install-prefix-ce }}/fedora/) | | [{{ green-check }}]({{ install-prefix-ce }}/fedora/) | | |
| [Ubuntu]({{ install-prefix-ce }}/ubuntu/) | [{{ green-check }}]({{ install-prefix-ce }}/ubuntu/) | [{{ green-check }}]({{ install-prefix-ce }}/ubuntu/) | [{{ green-check }}]({{ install-prefix-ce }}/ubuntu/) | [{{ green-check }}]({{ install-prefix-ce }}/ubuntu/) | [{{ green-check }}]({{ install-prefix-ce }}/ubuntu/) |
## Release channels ## Release channels
@ -118,8 +111,8 @@ The release channel for these builds is called `nightly`.
## Support ## Support
Docker Engine releases of a year-month branch are supported with patches as needed for 7 months after the first year-month general availability Docker Engine releases of a year-month branch are supported with patches as
release. needed for one month after the the next year-month general availability release.
This means bug reports and backports to release branches are assessed This means bug reports and backports to release branches are assessed
until the end-of-life date. until the end-of-life date.
@ -161,4 +154,4 @@ for it.
## Get started ## Get started
After setting up Docker, you can learn the basics with After setting up Docker, you can learn the basics with
[Getting started with Docker](/get-started/). [Getting started with Docker](/get-started/index.md).

1
install/linux/linux-postinstall.md → engine/install/linux-postinstall.md
View File

@ -5,6 +5,7 @@ title: Post-installation steps for Linux
redirect_from: redirect_from:
- /engine/installation/linux/docker-ee/linux-postinstall/ - /engine/installation/linux/docker-ee/linux-postinstall/
- /engine/installation/linux/linux-postinstall/ - /engine/installation/linux/linux-postinstall/
- /install/linux/linux-postinstall/
--- ---
This section contains optional procedures for configuring Linux hosts to work This section contains optional procedures for configuring Linux hosts to work

118
install/linux/docker-ce/ubuntu.md → engine/install/ubuntu.md
View File

@ -1,27 +1,28 @@
--- ---
description: Instructions for installing Docker Engine - Community on Ubuntu description: Instructions for installing Docker Engine on Ubuntu
keywords: requirements, apt, installation, ubuntu, install, uninstall, upgrade, update keywords: requirements, apt, installation, ubuntu, install, uninstall, upgrade, update
redirect_from: redirect_from:
- /engine/installation/ubuntulinux/ - /engine/installation/ubuntulinux/
- /installation/ubuntulinux/ - /installation/ubuntulinux/
- /engine/installation/linux/ubuntu/
- /engine/installation/linux/ubuntulinux/ - /engine/installation/linux/ubuntulinux/
- /engine/installation/linux/docker-ce/ubuntu/ - /engine/installation/linux/docker-ce/ubuntu/
- /install/linux/ubuntu/ - /install/linux/ubuntu/
- /engine/installation/linux/ubuntu/ - /install/linux/docker-ce/debian/
title: Get Docker Engine - Community for Ubuntu title: Install Docker Engine on Ubuntu
toc_max: 4 toc_max: 4
--- ---
To get started with Docker Engine - Community on Ubuntu, make sure you To get started with Docker Engine on Ubuntu, make sure you
[meet the prerequisites](#prerequisites), then [meet the prerequisites](#prerequisites), then
[install Docker](#install-docker-engine---community-1). [install Docker](#installation-methods).
## Prerequisites ## Prerequisites
### Docker EE customers ### Docker EE customers
To install Docker Enterprise Edition (Docker EE), go to To install Docker Enterprise Edition (Docker EE), go to
[Get Docker EE for Ubuntu](/install/linux/docker-ee/ubuntu.md) [Get Docker EE for Ubuntu](/ee/docker-ee/ubuntu.md)
**instead of this topic**. **instead of this topic**.
To learn more about Docker EE, see To learn more about Docker EE, see
@ -29,14 +30,14 @@ To learn more about Docker EE, see
### OS requirements ### OS requirements
To install Docker Engine - Community, you need the 64-bit version of one of these Ubuntu To install Docker Engine, you need the 64-bit version of one of these Ubuntu
versions: versions:
- Eoan 19.10 - Eoan 19.10
- Bionic 18.04 (LTS) - Bionic 18.04 (LTS)
- Xenial 16.04 (LTS) - Xenial 16.04 (LTS)
Docker Engine - Community is supported on `x86_64` (or `amd64`), `armhf`, `arm64`, `s390x` Docker Engine is supported on `x86_64` (or `amd64`), `armhf`, `arm64`, `s390x`
(IBM Z), and `ppc64le` (IBM Power) architectures. (IBM Z), and `ppc64le` (IBM Power) architectures.
### Uninstall old versions ### Uninstall old versions
@ -51,22 +52,19 @@ $ sudo apt-get remove docker docker-engine docker.io containerd runc
It's OK if `apt-get` reports that none of these packages are installed. It's OK if `apt-get` reports that none of these packages are installed.
The contents of `/var/lib/docker/`, including images, containers, volumes, and The contents of `/var/lib/docker/`, including images, containers, volumes, and
networks, are preserved. The Docker Engine - Community package is now called `docker-ce`. networks, are preserved. The Docker Engine package is now called `docker-ce`.
### Supported storage drivers ### Supported storage drivers
Docker Engine - Community on Ubuntu supports `overlay2`, `aufs` and `btrfs` storage drivers. Docker Engine on Ubuntu supports `overlay2`, `aufs` and `btrfs` storage drivers.
> **Note**: In Docker Engine - Enterprise, `btrfs` is only supported on SLES. See the documentation on
> [btrfs](/engine/userguide/storagedriver/btrfs-driver.md) for more details.
For new installations on version 4 and higher of the Linux kernel, `overlay2` Docker Engine uses the `overlay2` storage driver by default. If you need to use
is supported and preferred over `aufs`. Docker Engine - Community uses the `overlay2` `aufs` instead, you need to configure it manually.
storage driver by default. If you need to use `aufs` instead, you need to See [use the AUFS storage driver](/storage/storagedriver/aufs-driver.md)
configure it manually. See [aufs](/engine/userguide/storagedriver/aufs-driver.md)
## Install Docker Engine - Community ## Installation methods
You can install Docker Engine - Community in different ways, depending on your needs: You can install Docker Engine in different ways, depending on your needs:
- Most users - Most users
[set up Docker's repositories](#install-using-the-repository) and install [set up Docker's repositories](#install-using-the-repository) and install
@ -83,7 +81,7 @@ You can install Docker Engine - Community in different ways, depending on your n
### Install using the repository ### Install using the repository
Before you install Docker Engine - Community for the first time on a new host machine, you need Before you install Docker Engine for the first time on a new host machine, you need
to set up the Docker repository. Afterward, you can install and update Docker to set up the Docker repository. Afterward, you can install and update Docker
from the repository. from the repository.
@ -91,15 +89,12 @@ from the repository.
{% assign download-url-base = "https://download.docker.com/linux/ubuntu" %} {% assign download-url-base = "https://download.docker.com/linux/ubuntu" %}
1. Update the `apt` package index: 1. Update the `apt` package index and install packages to allow `apt` to use a
repository over HTTPS:
```bash ```bash
$ sudo apt-get update $ sudo apt-get update
```
2. Install packages to allow `apt` to use a repository over HTTPS:
```bash
$ sudo apt-get install \ $ sudo apt-get install \
apt-transport-https \ apt-transport-https \
ca-certificates \ ca-certificates \
@ -108,7 +103,7 @@ from the repository.
software-properties-common software-properties-common
``` ```
3. Add Docker's official GPG key: 2. Add Docker's official GPG key:
```bash ```bash
$ curl -fsSL {{ download-url-base }}/gpg | sudo apt-key add - $ curl -fsSL {{ download-url-base }}/gpg | sudo apt-key add -
@ -120,16 +115,16 @@ from the repository.
```bash ```bash
$ sudo apt-key fingerprint 0EBFCD88 $ sudo apt-key fingerprint 0EBFCD88
pub rsa4096 2017-02-22 [SCEA] pub rsa4096 2017-02-22 [SCEA]
9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88 9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88
uid [ unknown] Docker Release (CE deb) <docker@docker.com> uid [ unknown] Docker Release (CE deb) <docker@docker.com>
sub rsa4096 2017-02-22 [S] sub rsa4096 2017-02-22 [S]
``` ```
4. Use the following command to set up the **stable** repository. To add the 3. Use the following command to set up the **stable** repository. To add the
**nightly** or **test** repository, add the word `nightly` or `test` (or both) **nightly** or **test** repository, add the word `nightly` or `test` (or both)
after the word `stable` in the commands below. [Learn about **nightly** and **test** channels](/install/index.md). after the word `stable` in the commands below. [Learn about **nightly** and **test** channels](index.md).
> **Note**: The `lsb_release -cs` sub-command below returns the name of your > **Note**: The `lsb_release -cs` sub-command below returns the name of your
> Ubuntu distribution, such as `xenial`. Sometimes, in a distribution > Ubuntu distribution, such as `xenial`. Sometimes, in a distribution
@ -138,7 +133,6 @@ from the repository.
> `Linux Mint Tessa`, you could use `bionic`. Docker does not offer any guarantees on untested > `Linux Mint Tessa`, you could use `bionic`. Docker does not offer any guarantees on untested
> and unsupported Ubuntu distributions. > and unsupported Ubuntu distributions.
<ul class="nav nav-tabs"> <ul class="nav nav-tabs">
<li class="active"><a data-toggle="tab" data-target="#x86_64_repo">x86_64 / amd64</a></li> <li class="active"><a data-toggle="tab" data-target="#x86_64_repo">x86_64 / amd64</a></li>
<li><a data-toggle="tab" data-target="#armhf_repo">armhf</a></li> <li><a data-toggle="tab" data-target="#armhf_repo">armhf</a></li>
@ -199,17 +193,13 @@ from the repository.
</div> </div>
</div> <!-- tab-content --> </div> <!-- tab-content -->
#### Install Docker Engine - Community #### Install Docker Engine
1. Update the `apt` package index. 1. Update the `apt` package index, and install the _latest version_ of Docker
Engine and containerd, or go to the next step to install a specific version:
```bash ```bash
$ sudo apt-get update $ sudo apt-get update
```
2. Install the _latest version_ of Docker Engine - Community and containerd, or go to the next step to install a specific version:
```bash
$ sudo apt-get install docker-ce docker-ce-cli containerd.io $ sudo apt-get install docker-ce docker-ce-cli containerd.io
``` ```
@ -220,7 +210,8 @@ from the repository.
> `apt-get update` command always installs the highest possible version, > `apt-get update` command always installs the highest possible version,
> which may not be appropriate for your stability needs. > which may not be appropriate for your stability needs.
3. To install a _specific version_ of Docker Engine - Community, list the available versions in the repo, then select and install: 2. To install a _specific version_ of Docker Engine, list the available versions
in the repo, then select and install:
a. List the versions available in your repo: a. List the versions available in your repo:
@ -241,7 +232,7 @@ from the repository.
$ sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io $ sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io
``` ```
4. Verify that Docker Engine - Community is installed correctly by running the `hello-world` 3. Verify that Docker Engine is installed correctly by running the `hello-world`
image. image.
```bash ```bash
@ -251,34 +242,33 @@ from the repository.
This command downloads a test image and runs it in a container. When the This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits. container runs, it prints an informational message and exits.
Docker Engine - Community is installed and running. The `docker` group is created but no users Docker Engine is installed and running. The `docker` group is created but no users
are added to it. You need to use `sudo` to run Docker commands. are added to it. You need to use `sudo` to run Docker commands.
Continue to [Linux postinstall](/install/linux/linux-postinstall.md) to allow Continue to [Linux postinstall](linux-postinstall.md) to allow non-privileged
non-privileged users to run Docker commands and for other optional configuration users to run Docker commands and for other optional configuration steps.
steps.
#### Upgrade Docker Engine - Community #### Upgrade Docker Engine
To upgrade Docker Engine - Community, first run `sudo apt-get update`, then follow the To upgrade Docker Engine, first run `sudo apt-get update`, then follow the
[installation instructions](#install-docker-ce), choosing the new version you want [installation instructions](#install-using-the-repository), choosing the new
to install. version you want to install.
### Install from a package ### Install from a package
If you cannot use Docker's repository to install Docker Engine - Community, you can download the If you cannot use Docker's repository to install Docker Engine, you can download the
`.deb` file for your release and install it manually. You need to download `.deb` file for your release and install it manually. You need to download
a new file each time you want to upgrade Docker. a new file each time you want to upgrade Docker.
1. Go to [`{{ download-url-base }}/dists/`]({{ download-url-base }}/dists/){: target="_blank" class="_" }, 1. Go to [`{{ download-url-base }}/dists/`]({{ download-url-base }}/dists/){: target="_blank" class="_" },
choose your Ubuntu version, browse to `pool/stable/`, choose `amd64`, choose your Ubuntu version, then browse to `pool/stable/`, choose `amd64`,
`armhf`, `arm64`, `ppc64el`, or `s390x`, and download the `.deb` file for the `armhf`, `arm64`, `ppc64el`, or `s390x`, and download the `.deb` file for the
Docker Engine - Community version you want to install. Docker Engine version you want to install.
> **Note**: To install a **nightly** package, change the word > **Note**: To install a **nightly** or **test** (pre-release) package,
> `stable` in the URL to `nightly`. > change the word `stable` in the above URL to `nightly` or `test`.
> [Learn about **nightly** and **test** channels](/install/index.md). > [Learn about **nightly** and **test** channels](index.md).
2. Install Docker Engine - Community, changing the path below to the path where you downloaded 2. Install Docker Engine, changing the path below to the path where you downloaded
the Docker package. the Docker package.
```bash ```bash
@ -287,7 +277,7 @@ a new file each time you want to upgrade Docker.
The Docker daemon starts automatically. The Docker daemon starts automatically.
3. Verify that Docker Engine - Community is installed correctly by running the `hello-world` 3. Verify that Docker Engine is installed correctly by running the `hello-world`
image. image.
```bash ```bash
@ -297,25 +287,25 @@ a new file each time you want to upgrade Docker.
This command downloads a test image and runs it in a container. When the This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits. container runs, it prints an informational message and exits.
Docker Engine - Community is installed and running. The `docker` group is created but no users Docker Engine is installed and running. The `docker` group is created but no users
are added to it. You need to use `sudo` to run Docker commands. are added to it. You need to use `sudo` to run Docker commands.
Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md) Continue to [Post-installation steps for Linux](linux-postinstall.md) to allow
to allow non-privileged users to run Docker commands and for other optional non-privileged users to run Docker commands and for other optional configuration
configuration steps. steps.
#### Upgrade Docker Engine - Community #### Upgrade Docker Engine
To upgrade Docker Engine - Community, download the newer package file and repeat the To upgrade Docker Engine, download the newer package file and repeat the
[installation procedure](#install-from-a-package), pointing to the new file. [installation procedure](#install-from-a-package), pointing to the new file.
{% include install-script.md %} {% include install-script.md %}
## Uninstall Docker Engine - Community ## Uninstall Docker Engine
1. Uninstall the Docker Engine - Community package: 1. Uninstall the Docker Engine, CLI, and Containerd packages:
```bash ```bash
$ sudo apt-get purge docker-ce $ sudo apt-get purge docker-ce docker-ce-cli containerd.io
``` ```
2. Images, containers, volumes, or customized configuration files on your host 2. Images, containers, volumes, or customized configuration files on your host
@ -330,5 +320,5 @@ You must delete any edited configuration files manually.
## Next steps ## Next steps
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md). - Continue to [Post-installation steps for Linux](linux-postinstall.md).
- Review the topics in [Develop with Docker](/develop/index.md) to learn how to build new applications using Docker. - Review the topics in [Develop with Docker](/develop/index.md) to learn how to build new applications using Docker.

4
engine/release-notes/18.06.md
View File

@ -9,14 +9,14 @@ skip_read_time: true
2019-02-19 2019-02-19
### Security fixes for Docker Engine - Community ### Security fixes for Docker Engine
* Change how the `runc` critical vulnerability patch is applied to include the fix in RPM packages. [docker/engine#156](https://github.com/docker/engine/pull/156) * Change how the `runc` critical vulnerability patch is applied to include the fix in RPM packages. [docker/engine#156](https://github.com/docker/engine/pull/156)
## 18.06.2 ## 18.06.2
2019-02-11 2019-02-11
### Security fixes for Docker Engine - Community ### Security fixes for Docker Engine
* Update `runc` to address a critical vulnerability that allows specially-crafted containers to gain administrative privileges on the host. [CVE-2019-5736](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-5736) * Update `runc` to address a critical vulnerability that allows specially-crafted containers to gain administrative privileges on the host. [CVE-2019-5736](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-5736)
* Ubuntu 14.04 customers using a 3.13 kernel will need to upgrade to a supported Ubuntu 4.x kernel * Ubuntu 14.04 customers using a 3.13 kernel will need to upgrade to a supported Ubuntu 4.x kernel

4
engine/release-notes/index.md
View File

@ -1,6 +1,6 @@
--- ---
title: Docker Engine release notes title: Docker Engine release notes
description: Learn about the new features, bug fixes, and breaking changes for Docker Engine - Community description: Learn about the new features, bug fixes, and breaking changes for Docker Engine
keywords: docker, docker engine, ce, whats new, release notes keywords: docker, docker engine, ce, whats new, release notes
toc_min: 1 toc_min: 1
toc_max: 2 toc_max: 2
@ -11,7 +11,7 @@ redirect_from:
--- ---
This document describes the latest changes, additions, known issues, and fixes This document describes the latest changes, additions, known issues, and fixes
for Docker Engine - Community. for Docker Engine.
> **Note:** > **Note:**
> The client and container runtime are now in separate packages from the daemon > The client and container runtime are now in separate packages from the daemon

2
engine/swarm/index.md
View File

@ -5,7 +5,7 @@ title: Swarm mode overview
--- ---
To use Docker in swarm mode, install Docker. See To use Docker in swarm mode, install Docker. See
[installation instructions](/install/index.md) for all operating systems and platforms. [installation instructions](/get-docker.md) for all operating systems and platforms.
Current versions of Docker include *swarm mode* for natively managing a cluster Current versions of Docker include *swarm mode* for natively managing a cluster
of Docker Engines called a *swarm*. Use the Docker CLI to create a swarm, deploy of Docker Engines called a *swarm*. Use the Docker CLI to create a swarm, deploy

4
engine/swarm/swarm-tutorial/index.md
View File

@ -61,8 +61,8 @@ follows:
#### Install Docker Engine on Linux machines #### Install Docker Engine on Linux machines
If you are using Linux based physical computers or cloud-provided computers as If you are using Linux based physical computers or cloud-provided computers as
hosts, simply follow the [Linux install instructions](/install/index.md) for your platform. Spin up the three hosts, simply follow the [Linux install instructions](/engine/install/index.md)
machines, and you are ready. You can test both for your platform. Spin up the three machines, and you are ready. You can test both
single-node and multi-node swarm scenarios on Linux machines. single-node and multi-node swarm scenarios on Linux machines.
#### Use Docker Desktop for Mac or Docker Desktop for Windows #### Use Docker Desktop for Mac or Docker Desktop for Windows

6
get-docker.md
View File

@ -3,6 +3,10 @@ description: Home page for Get Docker
keywords: Docker, download, documentation, manual keywords: Docker, download, documentation, manual
landing: true landing: true
title: Get Docker title: Get Docker
redirect_from:
- /install/
- /install/overview/
- /installation/
--- ---
@ -36,7 +40,7 @@ You can download and install Docker on multiple platforms. Refer to the followin
<div class="component-icon"> <div class="component-icon">
<a href="install/linux/ubuntu/"> <img src="../images/linux_48.svg" alt="Docker for Linux"> </a> <a href="install/linux/ubuntu/"> <img src="../images/linux_48.svg" alt="Docker for Linux"> </a>
</div> </div>
<h3 id="docker-for-linux"><a href="install/linux/ubuntu/">Docker for Linux</a></h3> <h3 id="docker-for-linux"><a href="engine/install/">Docker for Linux</a></h3>
<p>Install Docker on a computer which already has a Linux distribution installed.</p> <p>Install Docker on a computer which already has a Linux distribution installed.</p>
</div> </div>
</div> </div>

7
engine/docker-overview.md → get-started/overview.md
View File

@ -6,6 +6,7 @@ redirect_from:
- /engine/userguide/basics/ - /engine/userguide/basics/
- /engine/introduction/understanding-docker/ - /engine/introduction/understanding-docker/
- /engine/understanding-docker/ - /engine/understanding-docker/
- /engine/docker-overview/
title: Docker overview title: Docker overview
--- ---
@ -260,8 +261,6 @@ the future, Docker may support other container formats by integrating with
technologies such as BSD Jails or Solaris Zones. technologies such as BSD Jails or Solaris Zones.
## Next steps ## Next steps
- Read about [installing Docker](installation/index.md#installation). - Read about [installing Docker](/get-docker.md).
- Get hands-on experience with the [Getting started with Docker](getstarted/index.md) - Get hands-on experience with the [Getting started with Docker](index.md)
tutorial. tutorial.
- Check out examples and deep dive topics in the
[Docker Engine user guide](userguide/index.md).

2
index.md
View File

@ -63,7 +63,7 @@ containers and automate the development pipeline from a single environment.
Choose the Edge channel to get access to the latest features, or the Stable Choose the Edge channel to get access to the latest features, or the Stable
channel for more predictability. channel for more predictability.
[Learn more about Docker Engine - Community](/install/){: class="button outline-btn"} [Learn more about Docker Engine - Community](/engine/index.md){: class="button outline-btn"}
</div> </div>
<div markdown="1" class="col-xs-12 col-sm-12 col-md-12 col-lg-6 block"> <div markdown="1" class="col-xs-12 col-sm-12 col-md-12 col-lg-6 block">

2
storage/storagedriver/aufs-driver.md
View File

@ -24,7 +24,7 @@ potential performance advantages over the `aufs` storage driver.
Stretch. Stretch.
- For Docker EE, AUFS is supported on Ubuntu. - For Docker EE, AUFS is supported on Ubuntu.
- If you use Ubuntu, you need to - If you use Ubuntu, you need to
[install extra packages](/install/linux/ubuntu.md#recommended-extra-packages-for-trusty-1404){: target="_blank" class="_"} [install extra packages](/engine/install/ubuntu.md#recommended-extra-packages-for-trusty-1404){: target="_blank" class="_"}
to add the AUFS module to the kernel. If you do not install these packages, to add the AUFS module to the kernel. If you do not install these packages,
you need to use `devicemapper` on Ubuntu 14.04 (which is not recommended), you need to use `devicemapper` on Ubuntu 14.04 (which is not recommended),
or `overlay2` on Ubuntu 16.04 and higher, which is also supported. or `overlay2` on Ubuntu 16.04 and higher, which is also supported.

4
storage/storagedriver/device-mapper-driver.md
View File

@ -26,10 +26,10 @@ a filesystem at the operating system (OS) level.
- `devicemapper` storage driver is a supported storage driver for Docker - `devicemapper` storage driver is a supported storage driver for Docker
EE on many OS distribution. See the EE on many OS distribution. See the
[Product compatibility matrix](https://success.docker.com/article/compatibility-matrix) for details. [Product compatibility matrix](https://success.docker.com/article/compatibility-matrix) for details.
- `devicemapper` is also supported on Docker Engine - Community running on CentOS, Fedora, - `devicemapper` is also supported on Docker Engine - Community running on CentOS, Fedora,
Ubuntu, or Debian. Ubuntu, or Debian.
- `devicemapper` requires the `lvm2` and `device-mapper-persistent-data` packages
to be installed.
- Changing the storage driver makes any containers you have already - Changing the storage driver makes any containers you have already
created inaccessible on the local system. Use `docker save` to save containers, created inaccessible on the local system. Use `docker save` to save containers,
and push existing images to Docker Hub or a private repository, so you do and push existing images to Docker Hub or a private repository, so you do

6
swarm/install-manual.md
View File

@ -109,9 +109,9 @@ To create the instances do the following:
## Step 3. Install Engine on each node ## Step 3. Install Engine on each node
1. [Install Docker](/install/){: target="_blank" class="_"} on each 1. [Install Docker](/engine/install/index.md){: target="_blank" class="_"}
host, using the appropriate instructions for your operating system and on each host, using the appropriate instructions for your operating system
distribution. and distribution.
2. Edit `/etc/docker/daemon.json`. Create it if it does not exist. Assuming the 2. Edit `/etc/docker/daemon.json`. Create it if it does not exist. Assuming the
file was empty, its contents should be: file was empty, its contents should be: