Topics

#docker #docker-cli #docker-engine #docker-swarm #golang

Language breakdown

Go 98.4%

Shell 1.3%

Makefile 0.3%

Dockerfile 0.0%

▸ Files click to expand

README

dry

[ Github All Releases ]()

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) 8 | show compose projects list ArrowUp or k | move the cursor one line up ArrowDown or j | move the cursor one line down g | move the cursor to the top G | move the cursor to the bottom : | open command palette Space | open Quick Peek for the current selection Ctrl+0 | cycle color theme (dark/light) q | quit 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

Keybinding | Description ---------------------|--------------------------------------- Enter | show container command menu (includes Attach for running containers) F2 | toggle on/off showing stopped containers i | inspect l | container logs e | remove s | stats x | exec a command in the selected container (default /bin/sh) Ctrl+e | remove all stopped containers Ctrl+k | kill Ctrl+r | start/restart Ctrl+t | stop

Image commands

Keybinding | Description ---------------------|--------------------------------------- i | history 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+r | remove service Ctrl+s | scale service Ctrl+u | update service Enter | show service tasks

Compose Projects commands

Keybinding | Description ---------------------|--------------------------------------- Enter | show project services l | project logs Ctrl+t | stop project containers Ctrl+r | restart project containers Ctrl+e | remove project containers

Compose Services commands

Keybinding | Description ---------------------|--------------------------------------- Enter | inspect service Esc | back to projects l | service logs Ctrl+s | start service containers Ctrl+t | stop service containers Ctrl+r | restart service containers Ctrl+e | remove service containers

Moving around buffers

Keybinding | Description ---------------------|--------------------------------------- ArrowUp or k | move the cursor one line up ArrowDown or j | 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.

darwin amd64 / arm64
freebsd 386 / amd64
linux 386 / amd64 / arm64 / armv6 / armv7
windows amd64

Mac OS X / Homebrew

If you're on OS X and want to use homebrew:

brew tap moncho/dry
brew install dry

Docker

run --rm -it -v /var/run/docker.sock:/var/run/docker.sock -e DOCKERHOST=$DOCKERHOST moncho/dry

Arch Linux

-S dry-bin

Usage

Open a console, type

. 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.