Need help with ctop?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

bcicen
10.8K Stars 416 Forks MIT License 563 Commits 57 Opened issues

Description

Top-like interface for container metrics

Services available

!
?

Need anything else?

Contributors list

ctop

release homebrew

Top-like interface for container metrics

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

ctop

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

bash
echo "deb http://packages.azlux.fr/debian/ buster main" | sudo tee /etc/apt/sources.list.d/azlux.list
wget -qO - https://azlux.fr/repo.gpg.key | sudo apt-key add -
sudo apt update
sudo apt install docker-ctop

Arch

ctop
is available for Arch in the AUR

Linux (Generic)

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

OS X

brew install ctop

or

bash
sudo curl -Lo /usr/local/bin/ctop https://github.com/bcicen/ctop/releases/download/v0.7.5/ctop-0.7.5-darwin-amd64
sudo chmod +x /usr/local/bin/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 
| 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 |

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.