Skip to content

Bash script showing running Docker containers and related resources


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



17 Commits

Repository files navigation


DockStat is a Bash script to show output of running Docker containers and related resources:

This is mainly good for small, developer Docker setups. It was originally created to monitor from two to eight containers that were continually being brought up and down and being pruned. Otherwise, for example, if Docker is used a lot with many disperate containers thus has lots images cached, DockStat lists ALL your images. Displaying dozens or more images will likely break the display functionally. KISS, 'kay?!

DockStat uses Simple Curses library to render the output in Bash.


To use DockStat:

  1. Ensure you have Docker installed
  2. Clone this repo
  3. cd into this repo
  4. Run ./

This should run on any OS, but has only been tested on Ubuntu.

Stats Shown

DockStat will list:

  • Host load average
  • Host total processes
  • Host total Docker processes
  • Per container table showing:
    • Name
    • Docker IP
    • Ports mapped
    • Up time with process count
  • Docker networks
  • Docker volumes
  • Docker images

Related work

Unsurprisingly, there's a lot of other great work in this area. Here's a list of projects as I've discovered them since writing DockStat:

  • ctop - Top-like interface for container metrics
  • lazydocker - Self desribed as "A simple terminal UI for both docker and docker-compose, written in Go with the gocui library."
  • docker stats - built into docker - just run it!
  • Dozzle - Self desribed as "Dozzle is a small lightweight application with a web based interface to monitor Docker logs. It doesn’t store any log files. It is for live monitoring of your container logs only."


Bash script showing running Docker containers and related resources