About ctop
ctop provides a top-like command-line interface to monitor container CPU, memory, and network metrics. It enables real-time interactive inspection and performance tracking of containers, streamlining infrastructure operations workflows.
Key features
- 01Display container CPU and memory usage in real time
- 02Monitor container network I/O statistics
- 03Interactive navigation and container inspection
Use cases
- 01Monitor resource consumption across multiple containers in production
- 02Diagnose container performance issues and identify bottlenecks
- 03Automate infrastructure monitoring workflows
Install
Pick your OS or package manager and run the command in a terminal.
Once installed, runctop --versionto confirm it works.
Example commands
Common commands in the order you’d use them.
Details
From the project README
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.
Install
Fetch the latest release for your platform:
Debian/Ubuntu
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
Arch
sudo pacman -S ctop
ctop is also available for Arch in the AUR
Linux (Generic)
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
OS X
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
Windows
ctop is available in scoop:
scoop install ctop
Docker
docker run --rm -ti \
--name=ctop \
--volume /var/run/docker.sock:/var/run/docker.sock:ro \
quay.io/vektorlab/ctop:latest
Building
Build steps can be found here.
Usage
ctop requires no arguments and uses Docker host variables by default. See connectors for further configuration options.
Config file
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.
Options
| 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 |
Keybindings
| Key | Action |
|---|---|
| <ENTER> | Open container menu |
| 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 |
| o | Open single view |
| l | View container logs (t to toggle timestamp when open) |
| e | Exec Shell |
| c | Configure columns |
| S | Save current configuration to file |
| q | Quit ctop |
Alternatives
See Awesome Docker list for similar tools to work with Docker.