dry is a terminal application to manage Docker containers and images. It aims to be an alternative to the official Docker CLI when it is needed to repeatedly execute commands on existing containers and images, and also as a tool to monitor Docker containers from a terminal.
Upon connecting to a Docker host (local or remote), the main screen will show the list of containers and version information as reported by the Docker Engine. At all times, information about containers and images shown by dry is up-to-date, even if commands are executed from outside the tool.
From the main screen, commands to start, stop, remove and several others can be executed, all of them behaving like the equivalent command from the official Docker CLI. A detailed list of available commands can be found in this README, command information can also be read while running dry by showing help [H].
Switching to the image screen can be done by clicking [1]. Once there, Docker images are shown and again a few commands are available. Clicking [1] will show again the main screen (the container list).
Take a look at the demo below too see what can be done with dry.
Available commands (and their keybind in dry) from the official Docker cli:
| Command | Key |
|---|---|
| info | [F10] |
| inspect | [Enter] |
| kill | [ctrl+k] |
| logs | [l] |
| ps | |
| rm | [e] |
| start | [ctrl+r] |
| stats | [s] |
| stop | [ctrl+t] |
Besides this, it:
- Shows real-time information about containers.
- Allows to sort the container list. [F1]
- Can search and navigate the output of info, inspect, logs commands.
- Allows to easily remove all stopped containers. [ctrl + E]
The easiest way to install the latest binaries for Linux and Mac is to run this in your shell:
$ curl -sSf https://moncho.github.io/dry/dryup.sh | sh
Most likely you will have to sudo it:
$ curl -sSf https://moncho.github.io/dry/dryup.sh | sudo sh
If you dont like to curl | sh, binaries are provided.
And if you just run what you compile, use the source.
Make sure that $GOPATH exists. Go get this project.
$ go get github.com/moncho/dry
$ cd $GOPATH/src/github.com/moncho/dry
This project uses godep to handle its dependencies.
$ go get github.com/tools/godep
$ godep restore
Build dry.
$ make install
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 immediately.
dry -p launches dry with pprof package active.
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.
Built on top of:
Also reused some code and ideas from the Docker project and mop.
