ohmyzsh/plugins/docker

Docker plugin

This plugin adds auto-completion and aliases for docker.

To use it add docker to the plugins array in your zshrc file.

plugins=(... docker)

A copy of the completion script from the docker/cli git repo: https://github.com/docker/cli/blob/master/contrib/completion/zsh/_docker

Settings

By default, the completion doesn't allow option-stacking, meaning if you try to complete docker run -it <TAB> it won't work, because you're stacking the -i and -t options.

You can enable it by adding the lines below to your zshrc file, but be aware of the side effects:

This enables Zsh to understand commands like docker run -it ubuntu. However, by enabling this, this also makes Zsh complete docker run -u<tab> with docker run -uapprox which is not valid. The users have to put the space or the equal sign themselves before trying to complete.

Therefore, this behavior is disabled by default. To enable it:

zstyle ':completion:*:*:docker:*' option-stacking yes
zstyle ':completion:*:*:docker-*:*' option-stacking yes

Use old-style completion

If the current completion does not work well for you, you can enable legacy completion instead with the following setting. See https://github.com/ohmyzsh/ohmyzsh/issues/11789 for more information.

zstyle ':omz:plugins:docker' legacy-completion yes

Aliases

Alias	Command	Description
dbl	docker build	Build an image from a Dockerfile
dcin	docker container inspect	Display detailed information on one or more containers
dcls	docker container ls	List all the running docker containers
dclsa	docker container ls -a	List all running and stopped containers
dib	docker image build	Build an image from a Dockerfile (same as docker build)
dii	docker image inspect	Display detailed information on one or more images
dils	docker image ls	List docker images
dipu	docker image push	Push an image or repository to a remote registry
dirm	docker image rm	Remove one or more images
dit	docker image tag	Add a name and tag to a particular image
dkil	docker kill	Kill one or more running containers
dlo	docker container logs	Fetch the logs of a docker container
dlof	docker container logs --follow	Fetch and follow the logs of a docker container
dnc	docker network create	Create a new network
dncn	docker network connect	Connect a container to a network
dndcn	docker network disconnect	Disconnect a container from a network
dni	docker network inspect	Return information about one or more networks
dnls	docker network ls	List all networks the engine daemon knows about, including those spanning multiple hosts
dnrm	docker network rm	Remove one or more networks
dpo	docker container port	List port mappings or a specific mapping for the container
dpu	docker pull	Pull an image or a repository from a registry
dpsh	docker push	Upload an image to a registry
dritrm	docker container run --rm -it	Create a new container, start it in an interactive shell and automatically remove it
dr	docker container run	Create a new container and start it using the specified command
drit	docker container run -it	Create a new container and start it in an interactive shell
dritbash	docker run -it --entrypoint /bin/bash	Create a new container and start it in an interactive mode with Bash
dritp	docker container run -it -v $PWD:/pwd -w /pwd	Create a new container and start it in an interactive mode, mounting current directory as /pwd
dritprm	docker container run --rm -it -v $PWD:/pwd -w /pwd	Create a new container and start it in an interactive mode with auto-removal, mounting current directory as /pwd
dritsh	docker run -it --entrypoint /bin/sh	Create a new container and start it in an interactive mode with shell
dritshp	docker run -it --entrypoint /bin/sh -v $PWD:/pwd -w /pwd	Create a new container and start it in an interactive mode with shell, mounting current directory as /pwd
drm	docker container rm	Remove the specified container(s)
drm!	docker container rm -f	Force the removal of a running container (uses SIGKILL)
drma!	docker container ls -a -q | xargs docker container rm -f	Force the removal all containers
drp	docker container run -v $PWD:/pwd -w /pwd	Run a container with the current directory mounted as /pwd
dst	docker container start	Start one or more stopped containers
drs	docker container restart	Restart one or more containers
dsta	docker stop $(docker ps -q)	Stop all running containers
dstat	docker container stats	Display a live stream of containers resource usage statistics
dstp	docker container stop	Stop one or more running containers
dtop	docker top	Display the running processes of a container
dvi	docker volume inspect	Display detailed information about one or more volumes
dvls	docker volume ls	List all the volumes known to docker
dvrm	docker volume rm	Remove one or more volumes
dcprune	docker container prune	Cleanup dangling containers
diprune	docker image prune	Cleanup dangling images
dvprune	docker volume prune	Cleanup dangling volumes
dxc	docker container exec	Run a new command in a running container
dxcit	docker container exec -it	Run a new command in a running container in an interactive shell

Custom functions (pseudo-aliases)

Name	Function	Description
dxcsh	dxcsh() { docker exec -it "$@" /bin/sh }	Run a interactive shell inside a running docker container
dxcbash	dxcbash() { docker exec -it "$@" /bin/bash }	Run a interactive bash inside a running docker container