# dry
[](https://github.com/moncho/dryblob/master/LICENSE)
[](https://goreportcard.com/report/github.com/moncho/dry)
[](https://godoc.org/github.com/moncho/dry)
[]()
[](https://github.com/moncho/dry/releases/latest)
[](https://snapcraft.io/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.
[](https://asciinema.org/a/35825?autoplay=1&speed=1.5)
## **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:
```sh
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](https://github.com/moncho/dry/releases/latest/download/dry-darwin-amd64) / [arm64](https://github.com/moncho/dry/releases/latest/download/dry-darwin-arm64)
* **freebsd** [386](https://github.com/moncho/dry/releases/latest/download/dry-freebsd-386) / [amd64](https://github.com/moncho/dry/releases/latest/download/dry-freebsd-amd64)
* **linux** [386](https://github.com/moncho/dry/releases/latest/download/dry-linux-386) / [amd64](https://github.com/moncho/dry/releases/latest/download/dry-linux-amd64) / [arm64](https://github.com/moncho/dry/releases/latest/download/dry-linux-arm64) / [armv6](https://github.com/moncho/dry/releases/latest/download/dry-linux-armv6) / [armv7](https://github.com/moncho/dry/releases/latest/download/dry-linux-armv7)
* **windows** [amd64](https://github.com/moncho/dry/releases/latest/download/dry-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
```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](https://golang.org/pkg/net/http/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](https://github.com/moncho/dry/blob/master/LICENSE) for the full license text.
## Credits
Built on top of:
* [Bubbletea](https://github.com/charmbracelet/bubbletea)
* [Bubbles](https://github.com/charmbracelet/bubbles)
* [Lipgloss](https://github.com/charmbracelet/lipgloss)
* [Docker](https://github.com/docker/docker)
* [Docker CLI](https://github.com/docker/cli)
## Alternatives
See [Awesome Docker list](https://github.com/veggiemonk/awesome-docker/blob/master/README.md#terminal) for similar tools to work with Docker.