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

update Docker machine install instructions per user feedback 

added uninstall steps

fixed line lengths

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
This commit is contained in:
Victoria Bialas 2017-01-05 16:24:26 -08:00
parent 5a70ee3591
commit 534349778e
1 changed files with 48 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
machine/install-machine.md
View File

@ -5,13 +5,15 @@ title: Install Docker Machine
---
On macOS and Windows, Machine is installed along with other Docker products when
you install the Docker Toolbox. For details on installing Docker Toolbox, see
the <a href="/installation/mac/" target="_blank">macOS
installation</a> instructions or <a
href="/docker-for-windows/" target="_blank">Windows
installation</a> instructions.
you install the [Docker for Mac](/docker-for-mac/index.md), [Docker for
Windows](/docker-for-windows/index.md), or [Docker
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 are on the <a href="https://github.com/docker/machine/releases/" target="_blank"> docker/machine release page</a> on GitHub.
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 are on the <a
href="https://github.com/docker/machine/releases/" target="_blank">
docker/machine release page</a> on GitHub.
## Installing Machine Directly
@ -20,16 +22,28 @@ If you want only Docker Machine, you can install the Machine binaries directly b
2. Download the Docker Machine binary and extract it to your PATH.
If you are running macOS or Linux:
If you are running on **macOS**:
$ curl -L https://github.com/docker/machine/releases/download/v0.8.2/docker-machine-`uname -s`-`uname -m` >/usr/local/bin/docker-machine && \
chmod +x /usr/local/bin/docker-machine
```console
$ curl -L https://github.com/docker/machine/releases/download/v0.9.0-rc2/docker-machine-`uname -s`-`uname -m` >/usr/local/bin/docker-machine && \
chmod +x /usr/local/bin/docker-machine
```
If you are running Windows with git bash
If you are running on **Linux**:
$ if [[ ! -d "$HOME/bin" ]]; then mkdir -p "$HOME/bin"; fi && \
curl -L https://github.com/docker/machine/releases/download/v0.8.2/docker-machine-Windows-x86_64.exe > "$HOME/bin/docker-machine.exe" && \
chmod +x "$HOME/bin/docker-machine.exe"
```console
$ curl -L https://github.com/docker/machine/releases/download/v0.9.0-rc2/docker-machine-`uname -s`-`uname -m` >/tmp/docker-machine &&
chmod +x /tmp/docker-machine &&
sudo cp /tmp/docker-machine /usr/local/bin/docker-machine
```
If you are running with **Windows** with git bash:
```console
$ if [[ ! -d "$HOME/bin" ]]; then mkdir -p "$HOME/bin"; fi && \
curl -L https://github.com/docker/machine/releases/download/v0.9.0-rc2/docker-machine-Windows-x86_64.exe > "$HOME/bin/docker-machine.exe" && \
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.
@ -54,7 +68,26 @@ prompt, add `$(__docker_machine_ps1)` to your `PS1` setting in `~/.bashrc`.
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 <a
href="https://github.com/docker/machine/tree/master/contrib/completion/bash"
target="_blank">top of each script</a>.
### How to uninstall
To uninstall Docker Machine:
* Remove the executable: `rm $(which docker-machine)`
* Optionally, remove the machines you created.
To remove each machine individually: `docker-machine rm <machine-name>`
To remove all machines: `docker-machine rm -f $(docker-machine ls -q)`
Removing machines is an optional step because there are cases where you might
want to save and migrate existing machines to a [Docker for
Mac](/docker-for-mac/index.md) or [Docker for
Windows](/docker-for-windows/index.md) environment, for example.
## Where to go next
@ -62,4 +95,4 @@ You can find additional documentation in the comments at the <a href="https://gi
- 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>
- <a href="/machine/reference/" target="_blank">Docker Machine subcommand reference</a>