Clarified Machine install commands on Windows (#4327)

* added more info re: Machine install commands on Windows

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* copyedits

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* review comments

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* more review comments

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

* kicking the build, added metadata for search

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
This commit is contained in:
Victoria Bialas 2017-08-22 16:19:16 -07:00 committed by GitHub
parent 0fb0104497
commit e047aaec7a
1 changed files with 20 additions and 16 deletions

View File

@ -1,6 +1,6 @@
---
description: How to install Docker Machine
keywords: machine, orchestration, install, installation, docker, documentation
keywords: machine, orchestration, install, installation, docker, documentation, uninstall Docker Machine, uninstall
title: Install Docker Machine
---
@ -11,14 +11,13 @@ Toolbox](/toolbox/overview.md).
If you want only Docker Machine, you can install the Machine binaries directly
by following the instructions in the next section. You can find the latest
versions of the binaries on the <a
href="https://github.com/docker/machine/releases/" target="_blank">
docker/machine release page</a> on GitHub.
versions of the binaries on the [docker/machine release
page](https://github.com/docker/machine/releases/){: target="_blank" class="_" }
on GitHub.
## Installing Machine Directly
## Installing Machine directly
1. Install <a href="/engine/installation/"
target="_blank">the Docker binary</a>.
1. Install [Docker](/engine/installation/index.md){: target="_blank" class="_" }.
2. Download the Docker Machine binary and extract it to your PATH.
@ -37,7 +36,7 @@ docker/machine release page</a> on GitHub.
sudo cp /tmp/docker-machine /usr/local/bin/docker-machine
```
If you are running with **Windows** with git bash:
If you are running with **Windows** with [Git BASH](https://git-for-windows.github.io/){: target="_blank" class="_"}:
```console
$ if [[ ! -d "$HOME/bin" ]]; then mkdir -p "$HOME/bin"; fi && \
@ -45,7 +44,12 @@ curl -L https://github.com/docker/machine/releases/download/v0.12.2/docker-machi
chmod +x "$HOME/bin/docker-machine.exe"
```
Otherwise, download one of the releases from the <a href="https://github.com/docker/machine/releases/" target="_blank"> docker/machine release page</a> directly.
> The above command will work on Windows only if you use a
terminal emulater such as [Git BASH](https://git-for-windows.github.io/){: target="_blank" class="_"}, which supports Linux commands like `chmod`.
{: .important}
Otherwise, download one of the releases from the [docker/machine release
page](https://github.com/docker/machine/releases/){: target="_blank" class="_" } directly.
3. Check the installation by displaying the Machine version:
@ -66,13 +70,13 @@ To install the scripts, copy or link them into your `/etc/bash_completion.d` or
`/usr/local/etc/bash_completion.d` directory. To enable the `docker-machine` shell
prompt, add `$(__docker_machine_ps1)` to your `PS1` setting in `~/.bashrc`.
PS1='[\u@\h \W$(__docker_machine_ps1)]\$ '
```
PS1='[\u@\h \W$(__docker_machine_ps1)]\$ '
```
You can find additional documentation in the comments at the <a
href="https://github.com/docker/machine/tree/master/contrib/completion/bash"
target="_blank">top of each script</a>.
You can find additional documentation in the comments at the [top of each script](https://github.com/docker/machine/tree/master/contrib/completion/bash){: target="_blank" class="_"}.
### How to uninstall
### How to uninstall Docker Machine
To uninstall Docker Machine:
@ -94,5 +98,5 @@ To uninstall Docker Machine:
- [Docker Machine overview](overview.md)
- Create and run a Docker host on your [local system using virtualization](get-started.md)
- Provision multiple Docker hosts [on your cloud provider](get-started-cloud.md)
- <a href="/machine/drivers/" target="_blank">Docker Machine driver reference</a>
- <a href="/machine/reference/" target="_blank">Docker Machine subcommand reference</a>
- [Docker Machine driver reference](/machine/drivers/index.md)
- [Docker Machine subcommand reference](/machine/reference/index.md)