mirror of https://github.com/docker/docs.git
78 lines
2.1 KiB
Markdown
78 lines
2.1 KiB
Markdown
---
|
|
description: Install Machine command-line completion
|
|
keywords: machine, docker, orchestration, cli, reference
|
|
title: Command-line completion
|
|
---
|
|
|
|
Docker Machine comes with [command completion](http://en.wikipedia.org/wiki/Command-line_completion)
|
|
for the bash and zsh shell.
|
|
|
|
## Installing Command Completion
|
|
|
|
### Bash
|
|
|
|
Make sure bash completion is installed. If you are using a current version of
|
|
Linux in a non-minimal installation, bash completion should be available.
|
|
|
|
On a Mac, install with `brew install bash-completion`.
|
|
|
|
Place the completion script in `/etc/bash_completion.d/` as follows:
|
|
|
|
* On a Mac:
|
|
|
|
```shell
|
|
sudo curl -L https://raw.githubusercontent.com/docker/machine/v{{site.machine_version}}/contrib/completion/bash/docker-machine.bash -o `brew --prefix`/etc/bash_completion.d/docker-machine
|
|
```
|
|
|
|
* On a standard Linux installation:
|
|
|
|
```shell
|
|
sudo curl -L https://raw.githubusercontent.com/docker/machine/v{{site.machine_version}}/contrib/completion/bash/docker-machine.bash -o /etc/bash_completion.d/docker-machine
|
|
```
|
|
|
|
Completion will be available upon next login.
|
|
|
|
|
|
### Zsh
|
|
|
|
Place the completion script in your `/path/to/zsh/completion`, using e.g. `~/.zsh/completion/`:
|
|
|
|
```shell
|
|
mkdir -p ~/.zsh/completion
|
|
curl -L https://raw.githubusercontent.com/docker/machine/v{{site.machine_version}}/contrib/completion/zsh/_docker-machine > ~/.zsh/completion/_docker-machine
|
|
```
|
|
|
|
Include the directory in your `$fpath`, e.g. by adding in `~/.zshrc`:
|
|
|
|
```shell
|
|
fpath=(~/.zsh/completion $fpath)
|
|
```
|
|
|
|
Make sure `compinit` is loaded or do it by adding in `~/.zshrc`:
|
|
|
|
```shell
|
|
autoload -Uz compinit && compinit -i
|
|
```
|
|
|
|
Then reload your shell:
|
|
|
|
```shell
|
|
exec $SHELL -l
|
|
```
|
|
|
|
## Available completions
|
|
|
|
Depending on what you typed on the command line so far, it will complete:
|
|
|
|
- commands and their options
|
|
- container IDs and names
|
|
- image repositories and image tags
|
|
- file paths
|
|
|
|
## Where to go next
|
|
|
|
* [Get started with a local VM](/machine/get-started.md)
|
|
* [Machine command-line reference](/machine/reference/index.md)
|
|
* [Machine drivers](/machine/drivers/index.md)
|
|
* [Machine concepts and help](/machine/concepts.md)
|