lazydocker/README.md
2019-06-23 17:49:10 +10:00

3.9 KiB

lazydocker CircleCI Go Report Card GolangCI GoDoc GitHub tag

A simple terminal UI for docker, written in Go with the gocui library.

Gif

Are YOU tired of this workflow:

  • recognise your local server isn't responding
  • run docker ps
  • see your container exited
  • place mouse at beginning of the container ID, drag to the end of the container ID
  • press cmd+c
  • run 'docker restart <cmd+v>'

sounds like you might want to give lazydocker a try!

Gif

Installation

Homebrew

brew tap jesseduffield/lazydocker
brew install lazydocker

Binary Release (Linux/OSX)

You can download a binary release here.

Go

go get github.com/jesseduffield/lazydocker

Usage

Call lazydocker in your terminal. I personally use this a lot so I've made an alias for it like so:

echo "alias ld='lazydocker'" >> ~/.zshrc

(you can substitute .zshrc for whatever rc file you're using)

  • Basic video tutorial here.
  • List of keybindings here.

Cool features

everything is one keypress away:

  • viewing the state of your docker or docker-compose container environment at a glance
  • viewing logs for a container/service
  • viewing cool ascii graphs of any container with any metric you want to measure (e.g. CPU percentage, memory usage)
  • attaching to a container/service
  • restarting/removing/rebuilding containers/services
  • viewing the ancestor layers of a given image
  • pruning containers, images, or volumes that are hogging up disk space

Contributing

We love your input! Please check out the contributing guide. For contributor discussion about things not better discussed here in the repo, join the slack channel

Slack

Donate

If you would like to support the development of lazydocker, please donate

Donate

Social

If you want to see what I (Jesse) am up to in terms of development, follow me on twitter or watch me program on twitch

Alternatives

  • docui (Skanehira beat me to the punch on making a docker terminal UI, so definitely check out that repo as well! I think the two repos can live in harmony though: lazydocker is more about managing existing containers/services, and docui is more about creating and configuring them).