Skip to content
Top-like interface for container metrics
Branch: master
Clone or download
bcicen Merge pull request #168 from CodeLingoBot/rewrite
Fix function comments based on best practices from Effective Go
Latest commit 0479d42 Mar 7, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci remove deprecated -e option Aug 19, 2017
_docs Update status.md Jan 24, 2019
config
connector Fix function comments based on best practices from Effective Go Mar 7, 2019
container Fix function comments based on best practices from Effective Go Mar 7, 2019
cwidgets
logging depend on io.WriteCloser instead of net.Conn Oct 25, 2018
models
widgets
.gitignore
Dockerfile
LICENSE
Makefile
README.md v0.7.2 Jan 24, 2019
VERSION v0.7.2 Jan 24, 2019
colors.go remove ignore of variable (unneeded when only index is needed) Oct 25, 2018
cursor.go
debug.go
go.mod
grid.go add support for alternative navigation Jun 28, 2018
install.sh
keys.go include <escape> in exit keygroup Jun 8, 2017
main.go
menus.go add keyboard shortcuts to container menu Jan 24, 2019

README.md

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 an 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:

Linux

sudo wget https://github.com/bcicen/ctop/releases/download/v0.7.2/ctop-0.7.2-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.7.2/ctop-0.7.2-darwin-amd64
sudo chmod +x /usr/local/bin/ctop

Docker

docker run --rm -ti \
  --name=ctop \
  -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 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. These settings 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
-scale-cpu show cpu as % of system total
-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)
S Save current configuration to file
q Quit ctop
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.