A simple terminal UI for both docker and docker-compose, written in Go with the [gocui](https://github.com/jroimartin/gocui 'gocui') library. ![CI](https://github.com/jesseduffield/lazygit/workflows/Continuous%20Integration/badge.svg) [![Go Report Card](https://goreportcard.com/badge/github.com/jesseduffield/lazydocker)](https://goreportcard.com/report/github.com/jesseduffield/lazydocker) [![GolangCI](https://golangci.com/badges/github.com/jesseduffield/lazydocker.svg)](https://golangci.com) [![GoDoc](https://godoc.org/github.com/jesseduffield/lazydocker?status.svg)](http://godoc.org/github.com/jesseduffield/lazydocker) ![GitHub repo size](https://img.shields.io/github/repo-size/jesseduffield/lazydocker) [![GitHub Releases](https://img.shields.io/github/downloads/jesseduffield/lazydocker/total)](https://github.com/jesseduffield/lazydocker/releases) [![GitHub tag](https://img.shields.io/github/tag/jesseduffield/lazydocker.svg)](https://github.com/jesseduffield/lazydocker/releases/latest) [![homebrew](https://img.shields.io/homebrew/v/lazydocker)](https://github.com/Homebrew/homebrew-core/blob/master/Formula/lazydocker.rb) ![Gif](/docs/resources/demo3.gif) [Demo](https://youtu.be/NICqQPxwJWw) ## Sponsors
Maintenance of this project is made possible by all the contributors and sponsors. If you'd like to sponsor this project and have your avatar or company logo appear below click here. 💙
## Elevator Pitch Minor rant incoming: Something's not working? Maybe a service is down. `docker-compose ps`. Yep, it's that microservice that's still buggy. No issue, I'll just restart it: `docker-compose restart`. Okay now let's try again. Oh wait the issue is still there. Hmm. `docker-compose ps`. Right so the service must have just stopped immediately after starting. I probably would have known that if I was reading the log stream, but there is a lot of clutter in there from other services. I could get the logs for just that one service with `docker compose logs --follow myservice` but that dies everytime the service dies so I'd need to run that command every time I restart the service. I could alternatively run `docker-compose up myservice` and in that terminal window if the service is down I could just `up` it again, but now I've got one service hogging a terminal window even after I no longer care about its logs. I guess when I want to reclaim the terminal realestate I can do `ctrl+P,Q`, but... wait, that's not working for some reason. Should I use ctrl+C instead? I can't remember if that closes the foreground process or kills the actual service. What a headache! Memorising docker commands is hard. Memorising aliases is slightly less hard. Keeping track of your containers across multiple terminal windows is near impossible. What if you had all the information you needed in one terminal window with every common command living one keypress away (and the ability to add custom commands as well). Lazydocker's goal is to make that dream a reality. - [Requirements](https://github.com/jesseduffield/lazydocker#requirements) - [Installation](https://github.com/jesseduffield/lazydocker#installation) - [Usage](https://github.com/jesseduffield/lazydocker#usage) - [Keybindings](/docs/keybindings) - [Cool Features](https://github.com/jesseduffield/lazydocker#cool-features) - [Contributing](https://github.com/jesseduffield/lazydocker#contributing) - [Video Tutorial](https://youtu.be/NICqQPxwJWw) - [Config Docs](/docs/Config.md) - [Twitch Stream](https://www.twitch.tv/jesseduffield) - [FAQ](https://github.com/jesseduffield/lazydocker#faq) ## Requirements - Docker >= **1.13** (API >= **1.25**) - Docker-Compose >= **1.23.2** (optional) ## Installation ### Homebrew Normally `lazydocker` formula can be found in the Homebrew core but we suggest you to tap our formula to get frequently updated one. It works with Linux, too. **Tap**: ```sh brew install jesseduffield/lazydocker/lazydocker ``` **Core**: ```sh brew install lazydocker ``` ### Scoop (Windows) You can install `lazydocker` using [scoop](https://scoop.sh/): ```sh scoop install lazydocker ``` ### Chocolatey (Windows) You can install `lazydocker` using [Chocolatey](https://chocolatey.org/): ```sh choco install lazydocker ``` ### asdf-vm You can install [asdf-lazydocker plugin](https://github.com/comdotlinux/asdf-lazydocker) using [asdf-vm](https://asdf-vm.com/): #### Setup (Once) ```sh asdf plugin add lazydocker https://github.com/comdotlinux/asdf-lazydocker.git ``` #### For Install / Upgrade ```sh asdf list all lazydocker asdf install lazydocker latest asdf global lazydocker latest ``` ### Binary Release (Linux/OSX/Windows) You can manually download a binary release from [the release page](https://github.com/jesseduffield/lazydocker/releases). Automated install/update, don't forget to always verify what you're piping into bash: ```sh curl https://raw.githubusercontent.com/jesseduffield/lazydocker/master/scripts/install_update_linux.sh | bash ``` The script installs downloaded binary to `$HOME/.local/bin` directory by default, but it can be changed by setting `DIR` environment variable. ### Go Required Go Version >= **1.16** ```sh go install github.com/jesseduffield/lazydocker@latest ``` Required Go version >= **1.8**, <= **1.17** ```sh go get github.com/jesseduffield/lazydocker ``` ### Arch Linux AUR You can install lazydocker using the [AUR](https://aur.archlinux.org/packages/lazydocker) by running: ```sh yay -S lazydocker ``` ### Docker [![Docker Pulls](https://img.shields.io/docker/pulls/lazyteam/lazydocker.svg)](https://hub.docker.com/r/lazyteam/lazydocker) [![Docker Stars](https://img.shields.io/docker/stars/lazyteam/lazydocker.svg)](https://hub.docker.com/r/lazyteam/lazydocker) [![Docker Automated](https://img.shields.io/docker/cloud/automated/lazyteam/lazydocker.svg)](https://hub.docker.com/r/lazyteam/lazydocker) 1.- If you have a ARM 32 bit v6 architecture ```sh docker build -t lazyteam/lazydocker \ --build-arg BASE_IMAGE_BUILDER=arm32v6/golang \ --build-arg GOARCH=arm \ --build-arg GOARM=6 \ https://github.com/jesseduffield/lazydocker.git ``` - If you have a ARM 32 bit v7 architecture ```sh docker build -t lazyteam/lazydocker \ --build-arg BASE_IMAGE_BUILDER=arm32v7/golang \ --build-arg GOARCH=arm \ --build-arg GOARM=7 \ https://github.com/jesseduffield/lazydocker.git ``` - If you have a ARM 64 bit v8 architecture ```sh docker build -t lazyteam/lazydocker \ --build-arg BASE_IMAGE_BUILDER=arm64v8/golang \ --build-arg GOARCH=arm64 \ https://github.com/jesseduffield/lazydocker.git ```