What is Docker Cluster Monitor?
Docker Cluster Monitor is a Terminal User Interface (TUI) tool that provides real-time monitoring of Docker containers running on remote servers. Rather than SSH-ing into servers individually, you get a unified dashboard from your local terminal.
Features
- Live dashboard — auto-refreshing container status with automatic updates every few seconds
- Color-coded metrics — green for healthy/low usage, cyan for moderate load, red for high CPU or memory consumption
- Compose-aware resources — displays CPU and memory usage relative to Docker Compose deployment limits, not just physical machine limits
- Zero configuration — requires only a server hostname to begin monitoring
- SSH support — works with SSH config entries, custom users, and sudo privileges
Installation
uv tool install dockerclustermon
# or
pip install dockerclustermon
Usage
dockerstatus server.example.com # Monitor a remote server
dockerstatus server.example.com myuser # Specify a non-root SSH user
dockerstatus my-server --ssh-config # Use SSH config entries
dockerstatus server.example.com --sudo # Run with sudo privileges
How It Works
Docker Cluster Monitor connects to remote servers over SSH, queries Docker for container status and resource usage, then renders a live-updating terminal dashboard with color-coded metrics. Resource percentages are calculated against your Docker Compose limits for accurate capacity visibility.