Docker-Docs/completion.md at d24aa7f7af144010649807d51da7f380f46cfec6

3.7 KiB

Raw Blame History

description	keywords	title
Compose CLI reference	fig, composition, compose, docker, orchestration, cli, reference	Command-line completion

Compose comes with command completion for the bash and zsh shell.

Install command completion

Bash

Make sure bash completion is installed.

Linux

On a current Linux OS (in a non-minimal installation), bash completion should be available.

Place the completion script in /etc/bash_completion.d/.

sudo curl -L https://raw.githubusercontent.com/docker/compose/{{site.compose_version}}/contrib/completion/bash/docker-compose -o /etc/bash_completion.d/docker-compose

Mac

Install via Homebrew

Install with brew install bash-completion.
After the installation, Brew displays the installation path. Make sure to place the completion script in the path.

For example, when running this command on Mac 10.13.2, place the completion script in /usr/local/etc/bash_completion.d/.
```
sudo curl -L https://raw.githubusercontent.com/docker/compose/{{site.compose_version}}/contrib/completion/bash/docker-compose -o /usr/local/etc/bash_completion.d/docker-compose
```

Add the following to your ~/.bash_profile:

if [ -f $(brew --prefix)/etc/bash_completion ]; then
. $(brew --prefix)/etc/bash_completion
fi

You can source your ~/.bash_profile or launch a new terminal to utilize completion.

Install via MacPorts

Run sudo port install bash-completion to install bash completion.

Add the following lines to ~/.bash_profile:

if [ -f /opt/local/etc/profile.d/bash_completion.sh ]; then
. /opt/local/etc/profile.d/bash_completion.sh
fi

You can source your ~/.bash_profile or launch a new terminal to utilize completion.

Zsh

Make sure you have installed oh-my-zsh on your computer.

With oh-my-zsh shell

Add docker and docker-compose to the plugins list in ~/.zshrc to run autocompletion within the oh-my-zsh shell. In the following example, ... represent other Zsh plugins you may have installed.

plugins=(... docker docker-compose
)

Without oh-my-zsh shell

Place the completion script in your /path/to/zsh/completion (typically ~/.zsh/completion/):

$ mkdir -p ~/.zsh/completion
$ curl -L https://raw.githubusercontent.com/docker/compose/{{site.compose_version}}/contrib/completion/zsh/_docker-compose > ~/.zsh/completion/_docker-compose

Include the directory in your $fpath by adding in ~/.zshrc:
```
fpath=(~/.zsh/completion $fpath)
```
Make sure compinit is loaded or do it by adding in ~/.zshrc:
```
autoload -Uz compinit && compinit -i
```
Then reload your shell:
```
exec $SHELL -l
```

Available completions

Depending on what you typed on the command line so far, it completes:

available docker-compose commands
options that are available for a particular command
service names that make sense in a given context, such as services with running or stopped instances or services based on images vs. services based on Dockerfiles. For docker-compose scale, completed service names automatically have "=" appended.
arguments for selected options. For example, docker-compose kill -s completes some signals like SIGHUP and SIGUSR1.

Enjoy working with Compose faster and with fewer typos!

3.7 KiB Raw Blame History