dry
Dry is a terminal application to manage Docker and Docker Swarm.
It shows information about Containers, Images and Networks, and, if running a Swarm cluster, it shows information about Nodes, Service, Stacks and the rest of Swarm constructs. It can be used with both local or remote Docker daemons.
Besides showing information, it can be used to manage Docker. Most of the commands that the official Docker CLI provides, are available in dry with the same behaviour. A list of available commands and their keybindings can be found in dry's help screen or in this README.
Lastly, it can also be used as a monitoring tool for Docker containers.
Dry is installed as a single binary and does not require external libraries.
The demo below shows a dry session.
dry keybinds
Global
Keybinding | Description |
---|---|
% | filter list |
F1 | sort list |
F5 | refresh list |
F7 | toggle showing Docker daemon information |
F8 | show docker disk usage |
F9 | show last 10 docker events |
F10 | show docker info |
1 | show container list |
2 | show image list |
3 | show network list |
4 | show volumes list |
5 | show node list (on Swarm mode) |
6 | show service list (on Swarm mode) |
7 | show stacks list (on Swarm mode) |
ArrowUp | move the cursor one line up |
ArrowDown | move the cursor one line down |
g | move the cursor to the top |
G | move the cursor to the bottom |
q | quit dry |
Container commands
Keybinding | Description |
---|---|
Enter | show container command menu |
F2 | toggle on/off showing stopped containers |
i | inspect |
l | container logs |
e | remove |
s | stats |
Ctrl+e | remove all stopped containers |
Ctrl+k | kill |
Ctrl+l | container logs with Docker timestamps |
Ctrl+r | start/restart |
Ctrl+t | stop |
Image commands
Keybinding | Description |
---|---|
i | history |
r | run command in new container |
Ctrl+d | remove dangling images |
Ctrl+e | remove image |
Ctrl+f | remove image (force) |
Ctrl+u | remove unused images |
Enter | inspect |
Network commands
Keybinding | Description |
---|---|
Ctrl+e | remove network |
Enter | inspect |
Volume commands
Keybinding | Description |
---|---|
Ctrl+a | remove all volumes |
Ctrl+e | remove volume |
Ctrl+f | remove volume (force) |
Ctrl+u | remove unused volumes |
Enter | inspect |
Service commands
Keybinding | Description |
---|---|
i | inspect service |
l | service logs |
Ctrl+l | service logs with Docker timestamps |
Ctrl+r | remove service |
Ctrl+s | scale service |
Ctrl+u | update service |
Enter | show service tasks |
Moving around buffers
Keybinding | Description |
---|---|
ArrowUp | move the cursor one line up |
ArrowDown | move the cursor one line down |
g | move the cursor to the beginning of the buffer |
G | move the cursor to the end of the buffer |
n | after search, move forwards to the next search hit |
N | after search, move backwards to the previous search hit |
s | search |
pg up | move the cursor "screen size" lines up |
pg down | move the cursor "screen size" lines down |
Installation
The easiest way to install the latest binaries for Linux and Mac is to run this in a shell:
curl -sSf https://moncho.github.io/dry/dryup.sh | sudo sh
sudo chmod 755 /usr/local/bin/dry
Binaries
If you dont like to curl | sh, binaries are provided.
Mac OS X / Homebrew
If you're on OS X and want to use homebrew:
brew tap moncho/dry
brew install dry
Docker
docker run --rm -it -v /var/run/docker.sock:/var/run/docker.sock -e DOCKER_HOST=$DOCKER_HOST moncho/dry
Arch Linux
yaourt -S dry-bin
Usage
Open a console, type dry
. It will try to connect to:
- A Docker host given as a parameter (-H).
- if none given, a Docker host defined in the $DOCKER_HOST environment variable.
- if not defined, to unix:///var/run/docker.sock.
If no connection with a Docker host succeeds, dry will exit.
dry -p
launches dry with pprof package active.
Contributing
All contributions are welcome.
- Fork the project.
- Make changes on a topic branch.
- Pull request.
Copyright and license
Code released under the MIT license. See LICENSE for the full license text.
Credits
Built on top of:
Alternatives
See Awesome Docker list for similar tools to work with Docker.