bcicen /ctop

Top-like interface for container metrics

★ 17,851⑂ 594👁 165⑃ 124● 253▤ 16
GoMITCreated 2016-12-27ctop.sh
下载:v0.7.7v0.7.7 ↓0.7.72022-03-22
-1
日增长
17,851
stars
594
forks
165
watchers
124
prs
253
issues
16
releases

README

![release][release] ![homebrew][homebrew] ![macports][macports] ![scoop][scoop]

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][single_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
bash
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

bash
sudo pacman -S ctop


_ctop is also available for Arch in the AUR_


 Linux (Generic)

bash
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

bash
brew install ctop

or
bash
sudo port install ctop

or
bash
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:

powershell
scoop install ctop


 Docker

bash
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][build].

 Usage

ctop requires no arguments and uses Docker host variables by default. See [connectors][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  | 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                                           |

Top issues

Latest release

v0.7.7 v0.7.7 2022-03-22
Adds uptime column
 CPU bar color thresholds update
 Updated container status icons
 Optimize health status event handling
 Adds ppc64le build
 Adds "open in browser" menu option
 Fix CPU count estimation

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON