README.md
Top-like interface for container metrics
ctop provides a concise and condensed overview of real-time metrics for multiple containers:
as well as a single container view for inspecting a specific container.
ctop comes with built-in support for Docker and runC; connectors for other container and cluster systems are planned for future releases.
Fetch the latest release for your platform:
Maintained by a third party
sudo apt-get install ca-certificates curl gnupg lsb-release
curl -fsSL https://azlux.fr/repo.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/azlux-archive-keyring.gpg
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/azlux-archive-keyring.gpg] http://packages.azlux.fr/debian \
$(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/azlux.list >/dev/null
sudo apt-get update
sudo apt-get install docker-ctop
sudo pacman -S ctop
ctop is also available for Arch in the AUR
sudo wget https://github.com/bcicen/ctop/releases/download/v0.7.7/ctop-0.7.7-linux-amd64 -O /usr/local/bin/ctop
sudo chmod +x /usr/local/bin/ctop
brew install ctop
or
sudo port install ctop
or
sudo curl -Lo /usr/local/bin/ctop https://github.com/bcicen/ctop/releases/download/v0.7.7/ctop-0.7.7-darwin-amd64
sudo chmod +x /usr/local/bin/ctop
ctop is available in scoop:
scoop install ctop
docker run --rm -ti \
--name=ctop \
--volume /var/run/docker.sock:/var/run/docker.sock:ro \
quay.io/vektorlab/ctop:latest
Build steps can be found here.
ctop requires no arguments and uses Docker host variables by default. See connectors for further configuration options.
While running, use S to save the current filters, sort field, and other options to a default config path (~/.config/ctop/config on XDG systems, else ~/.ctop).
Config file values will be loaded and applied the next time ctop is started.
| Option | Description |
|---|---|
-a | show active containers only |
-f <string> | 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 |
| Key | Action |
|---|---|
| <kbd><ENTER></kbd> | Open container menu |
| <kbd>a</kbd> | Toggle display of all (running and non-running) containers |
| <kbd>f</kbd> | Filter displayed containers (esc to clear when open) |
| <kbd>H</kbd> | Toggle ctop header |
| <kbd>h</kbd> | Open help dialog |
| <kbd>s</kbd> | Select container sort field |
| <kbd>r</kbd> | Reverse container sort order |
| <kbd>o</kbd> | Open single view |
| <kbd>l</kbd> | View container logs (t to toggle timestamp when open) |
| <kbd>e</kbd> | Exec Shell |
| <kbd>c</kbd> | Configure columns |
| <kbd>S</kbd> | Save current configuration to file |
| <kbd>q</kbd> | Quit ctop |
See Awesome Docker list for similar tools to work with Docker.