Top-like interface for container metrics

ctop provides a concise and condensed overview of real-time metrics for multiple containers:

as well as an expanded view for inspecting a specific container.

ctop currently comes with built-in support for Docker; connectors for other container and cluster systems are planned for future releases.

Install

Fetch the latest release for your platform:

Linux

sudo wget https://github.com/bcicen/ctop/releases/download/v0.5/ctop-0.5-linux-amd64 -O /usr/local/bin/ctop
sudo chmod +x /usr/local/bin/ctop

OS X

brew install ctop

or

sudo curl -Lo /usr/local/bin/ctop https://github.com/bcicen/ctop/releases/download/v0.5/ctop-0.5-darwin-amd64
sudo chmod +x /usr/local/bin/ctop

or run via Docker:

docker run -ti --name ctop --rm -v /var/run/docker.sock:/var/run/docker.sock quay.io/vektorlab/ctop:latest

ctop is also available for Arch in the AUR

Building

Build steps can be found here.

Usage

ctop requires no arguments and will configure itself using the DOCKER_HOST environment variable

export DOCKER_HOST=tcp://127.0.0.1:4243
ctop

Options

Option	Description
-a	show active containers only
-f	set an initial filter string
-h	display help dialog
-i	invert default colors
-r	reverse container sort order
-s	select initial container sort field
-v	output version information and exit

Keybindings

Key	Action
a	Toggle display of all (running and non-running) containers
f	Filter displayed containers (esc to clear when open)
H	Toggle ctop header
h	Open help dialog
s	Select container sort field
r	Reverse container sort order
q	Quit ctop