dry

March 29, 2026 ยท View on GitHub

MIT License Build Status Release Go Report Card GoDoc Github All Releases Release 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.

asciicast

dry keybinds

Global

KeybindingDescription
%filter list
F1sort list
F5refresh list
F7toggle showing Docker daemon information
F8show docker disk usage
F9show last 10 docker events
F10show docker info
1show container list
2show image list
3show network list
4show volumes list
5show node list (on Swarm mode)
6show service list (on Swarm mode)
7show stacks list (on Swarm mode)
8show compose projects list
ArrowUp or kmove the cursor one line up
ArrowDown or jmove the cursor one line down
gmove the cursor to the top
Gmove the cursor to the bottom
:open command palette
Spaceopen Quick Peek for the current selection
Ctrl+0cycle color theme (dark/light)
qquit dry

Workspace mode (--workspace)

dry --workspace enables the Phase 1 workspace shell. This keeps the current list view visible together with a passive context pane and a bottom activity pane.

  • Tab and Shift+Tab switch focus between Navigator, Context, and Activity in the full workspace layout.
  • When Context is focused, you can scroll it with the usual navigation keys.
  • p / P pins or unpins the current preview.
  • : opens the command palette with global and context-aware actions.
  • Space opens Quick Peek, a temporary side panel with recent logs or inspect/details for the current selection.
  • f toggles follow mode in the activity pane.
  • Existing primary actions stay on their original keys. For example, Enter still opens the container command menu and still inspects resources in views where Enter already meant inspect/drill-down.
  • Embedded activity logs start from a recent tail instead of replaying the full log history.
  • On narrow or short terminals, workspace mode falls back to a compact single-pane layout and lets Tab switch between navigator and activity.

Container commands

KeybindingDescription
Entershow container command menu (includes Attach for running containers)
F2toggle on/off showing stopped containers
iinspect
lcontainer logs
eremove
sstats
xexec a command in the selected container (default /bin/sh)
Ctrl+eremove all stopped containers
Ctrl+kkill
Ctrl+rstart/restart
Ctrl+tstop

Image commands

KeybindingDescription
ihistory
Ctrl+dremove dangling images
Ctrl+eremove image
Ctrl+fremove image (force)
Ctrl+uremove unused images
Enterinspect

Network commands

KeybindingDescription
Ctrl+eremove network
Enterinspect

Volume commands

KeybindingDescription
Ctrl+aremove all volumes
Ctrl+eremove volume
Ctrl+fremove volume (force)
Ctrl+uremove unused volumes
Enterinspect

Service commands

KeybindingDescription
iinspect service
lservice logs
Ctrl+rremove service
Ctrl+sscale service
Ctrl+uupdate service
Entershow service tasks

Compose Projects commands

KeybindingDescription
Entershow project services
lproject logs
Ctrl+tstop project containers
Ctrl+rrestart project containers
Ctrl+eremove project containers

Compose Services commands

KeybindingDescription
Enterinspect service
Escback to projects
lservice logs
Ctrl+sstart service containers
Ctrl+tstop service containers
Ctrl+rrestart service containers
Ctrl+eremove service containers

Moving around buffers

KeybindingDescription
ArrowUp or kmove the cursor one line up
ArrowDown or jmove the cursor one line down
gmove the cursor to the beginning of the buffer
Gmove the cursor to the end of the buffer
nafter search, move forwards to the next search hit
Nafter search, move backwards to the previous search hit
ssearch
pg upmove the cursor "screen size" lines up
pg downmove 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

yay -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 -T light launches dry with the light color theme. Available themes: dark (default), light.

dry --workspace launches the experimental Phase 1 workspace layout.

dry -p launches dry with pprof package active.

Contributing

All contributions are welcome.

  • Fork the project.
  • Make changes on a topic branch.
  • Pull request.

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.