diff --git a/engine/getstarted/linux_install_help.md b/engine/getstarted/linux_install_help.md index c0459837ef..c06604f0b4 100644 --- a/engine/getstarted/linux_install_help.md +++ b/engine/getstarted/linux_install_help.md @@ -3,36 +3,72 @@ description: Getting started with Docker keywords: beginner, getting started, Docker, install redirect_from: - /mac/started/ -title: 'Example: Install Docker on Ubuntu Linux' +title: Install Docker using a shell script --- -This installation procedure for users who are unfamiliar with package -managers, and just want to try out the Getting Started tutorial while running Docker on Linux. If you are comfortable with package managers, prefer not to use -`curl`, or have problems installing and want to troubleshoot, please use our -`apt` and `yum` repositories instead for your installation. +This installation procedure for users who don't want to use a package manager to +install Docker. The script works on a "best effort" basis to determine your +operating system and environment, and attempts to provide reasonable defaults. +The script may allow you to install Docker in environments that are not actually +supported configurations. -1. Log into your Ubuntu installation as a user with `sudo` privileges. +If you can use a package manager, you should use the +[recommended installation procedure for your operating system](/engine/installation/) +instead. Using a package manager ensures that you get upgrades when they are +available, and allows you to install a specific version of Docker, rather than +the very latest version. -2. Verify that you have `curl` installed. +## Prerequisites - $ which curl +- You need `sudo` access on Linux, or administrator access on Windows. +- You need `curl` or `wget` installed. These instructions use `curl`, but you + can adapt them to use `wget`. - If `curl` isn't installed, install it after updating your manager: +## Install Docker using the `install.sh` script - $ sudo apt-get update - $ sudo apt-get install curl +> **Warning**: Always examine shell scripts you download from the internet before +> running them. -3. Get the latest Docker package. +1. Open [https://get.docker.com](https://get.docker.com/) in your web browser + so that you can examine the script before running it. This is important + because the script will run with elevated privileges. - $ curl -fsSL https://get.docker.com/ | sh +2. Run the script, using `curl` to download it and piping it through `sh`: - The system prompts you for your `sudo` password. Then, it downloads and - installs Docker and its dependencies. + ```bash + $ curl -fsSL https://get.docker.com/ | sh + ``` - >**Note**: If your company is behind a filtering proxy, you may find that the - >`apt-key` - >command fails for the Docker repo during installation. To work around this, - >add the key directly using the following: + You are prompted for your `sudo` password. The script determines your + operating system, downloads and installs Docker and its dependencies, starts + Docker, and attempts to configure your operating system to start Docker + automatically. + + > **Note**: Ubuntu or Debian users whose host is behind a filtering proxy + > may experience failure of the `apt-key` step during Docker installation. + > To work around this, use the following command to manually add the Docker + > key: > > $ curl -fsSL https://get.docker.com/gpg | sudo apt-key add - + + 3. On Ubuntu or Debian systems, the script attempts to start Docker and to + configure the system to start Docker automatically. On RPM-based platforms, + use the following command to start Docker: + + ```bash + $ sudo systemctl start docker + ``` + + If you have an older system that does not have `systemctl`, use the + `service` command instead: + + ```bash + $ sudo service docker start + ``` + + To configure Docker to start automatically on RPM-based systems, see + [Configure Docker to start on boot](/engine/installation/linux/linux-postinstall.md#configure-docker-to-start-on-boot). + + 4. If you installed using this mechanism, Docker will not be upgraded + automatically when new versions are available. Instead, repeat this + procedure to upgrade Docker. diff --git a/engine/installation/binaries.md b/engine/installation/binaries.md index faf4601bd6..7475579bfa 100644 --- a/engine/installation/binaries.md +++ b/engine/installation/binaries.md @@ -169,7 +169,7 @@ You can install Docker from binaries on Windows Server 2016 or Windows 10. 1. Use the following PowerShell commands to install and start Docker: ```none - Invoke-WebRequest https://get.docker.com/builds/Windows/x86_64/docker-1.13.0.zip -UseBasicParsing -OutFile docker.zip + Invoke-WebRequest https://get.docker.com/builds/Windows/x86_64/docker-17.03.0-ce.zip -UseBasicParsing -OutFile docker.zip Expand-Archive docker.zip -DestinationPath $Env:ProgramFiles Remove-Item -Force docker.zip