Skip to content
/ dry Public
forked from moncho/dry

dry - A Docker container manager for the terminal @

License

Notifications You must be signed in to change notification settings

azyshalom/dry

 
 

Repository files navigation

dry

MIT License wercker status Go Report Card GoDoc Coverage Status Github All Releases Join the chat at https://gitter.im/moncho/dry

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.

The demo below shows a dry session.

asciicast

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, images and networks shown by dry is up-to-date.

Most of the commands that can be executed with the official Docker CLI on containers, images and networks are available in dry, with the exact same behaviour. A list of available commands and their keybinds can be found in dry help screen.

Besides this, it:

  • Shows real-time information about containers.
  • Can sort the container, image and network lists.
  • Can navigate and search the output of info, inspect and logs commands.
  • Makes easier to cleanup old images and containers.

dry keybinds

Global

[F1]        sort list
[F5]        refresh list
[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 node list (on Swarm mode)
[5]         show service 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

[Enter]     show container command menu
[F2]        toggle on/off showing stopped containers
[F3]        filter containers
[i]         inspect
[Ctrl]+[k]  kill
[l]         logs
[e]         remove
[Ctrl]+[e]  remove all stopped containers
[Ctrl]+[r]  start/restart
[s]         stats
[Ctrl]+[t]  stop

Image commands

[i]         history
[Ctrl]+[d]    remove dangling images
[Ctrl]+[e]    remove image
[Ctrl]+[f]    remove image (force)
[Enter]     inspect

Network commands

[Ctrl]+[e]    remove network
[Enter]     inspect

Moving around buffers

[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 your shell:

curl -sSf https://moncho.github.io/dry/dryup.sh | sudo sh

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 -it -v /var/run/docker.sock:/var/run/docker.sock 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 immediately.

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:

Also reused some code and ideas from the Docker project.

About

dry - A Docker container manager for the terminal @

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 97.1%
  • Shell 2.3%
  • Makefile 0.6%