Update URL for Windows binaries, rewrite install.sh topic (#2354)

This commit is contained in:
Misty Stanley-Jones 2017-03-28 09:15:36 -07:00 committed by GitHub
parent 878670c252
commit cd89f5434d
2 changed files with 57 additions and 21 deletions

View File

@ -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` <a href="/engine/installation/"
target="_blank">repositories instead for your installation</a>.
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.

View File

@ -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