dockertop

htop-style view of Docker containers, and of the processes inside each one. Linux only.

The main screen lists every container with CPU (100% = one core), memory and its share of the container's limit, network and block I/O per second, process count, status and image. The header totals CPU and memory across all containers against the host. t groups containers under their compose project with the project's totals.

Enter on a container opens an htop for it: every process in its cgroup with host PID, user, priority, nice, VIRT, RES, state, CPU%, MEM% (of the container's limit), TIME+ and command, flat or as a tree. The header shows the container's CPU against its limit, memory against its limit, tasks, threads, pids limit, I/O rates and uptime.

d shows details (image, command, state, health check, limits, networks, ports, mounts, labels; environment hidden until you press e) and l follows the logs. Actions, each confirmed first: stop/start (x), restart (r), pause/unpause (p) and send a signal (k), to the container or, in the process view, to the selected process. Search (/), sort (s), show stopped (a), command line (c), help (h). Settings persist in ~/.config/dockertop/config. See man dockertop.

It talks to the Engine API over the Docker socket directly, so you need to be in the docker group or root. dockertop NAME opens straight into a container's processes.

dockertop
dockertop -t -r          # grouped by compose project, running only
dockertop my-container   # straight into its process view

Install

# Homebrew (Linux)
brew install andydixon/tap/dockertop

# Debian, Ubuntu
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://repo.dixon.cx/dixon.gpg | sudo tee /etc/apt/keyrings/dixon.gpg >/dev/null
echo "deb [signed-by=/etc/apt/keyrings/dixon.gpg] https://repo.dixon.cx/apt stable main" |
    sudo tee /etc/apt/sources.list.d/dixon.list
sudo apt update && sudo apt install dockertop

# Fedora, RHEL, AlmaLinux, Rocky
sudo curl -fsSL -o /etc/yum.repos.d/dixon.repo https://repo.dixon.cx/rpm/dixon.repo
sudo dnf install dockertop

# openSUSE
sudo zypper addrepo https://repo.dixon.cx/rpm/dixon.repo
sudo zypper install dockertop

# Arch Linux
curl -fsSL https://repo.dixon.cx/dixon.asc | sudo pacman-key --add -
sudo pacman-key --lsign-key C22FF7330668417C62C7A304CBC7951D7F2234D1
printf '\n[dixon]\nServer = https://repo.dixon.cx/arch/$arch\n' | sudo tee -a /etc/pacman.conf
sudo pacman -Sy dockertop

# From source
go install github.com/andydixon/dockertop@latest
# or
git clone https://github.com/andydixon/dockertop && cd dockertop && make && sudo make install

More at repo.dixon.cx.

Development

make            # build bin/dockertop
make test vet   # tests and go vet (CI runs these plus gofmt on every push)
make man        # preview the manpage
make install    # binary and manpage under /usr/local (PREFIX, DESTDIR)

Releases: tag vX.Y.Z and push it, then make brew-formula writes the Homebrew formula for the tap and make repo builds and publishes the .deb, .rpm and Arch packages to repo.dixon.cx.

Licence

GPL-3.0-or-later. Andy Dixon, www.dixon.cx.