dockerclustermon 0.3.1

A CLI tool for a live view of your docker containers running on a remote server.

Docker Cluster Monitor

Stop SSH-ing into servers just to check container status.

Get a live, color-coded dashboard of all your Docker containers across remote servers-right from your terminal. See CPU, memory, and health at a glance, updated automatically every few seconds.

Why Docker Cluster Monitor?

⚡ Save Time: No more logging into servers to run docker stats or docker ps
👀 Instant Clarity: Color-coded metrics show problems at a glance
🔄 Stay Informed: Auto-refreshing dashboard keeps you updated
🚀 Zero Configuration: Just point it at your server and go

See Everything at a Glance

Smart color coding helps you spot issues instantly:

• 🟢 Green: Healthy, low resource usage
• 🔵 Cyan: Moderate load-everything's fine
• 🔴 Red: High CPU or memory usage-time to investigate

Memory percentages reflect your Docker Compose deployment limits, so you know exactly how close each container is to its configured threshold-not just the physical machine limits.

Quick Start

Install

Using uv (recommended):

uv tool install dockerclustermon

Note: Make sure you have uv installed first.

Monitor Your Containers

Run dockerstatus (or the shorter ds alias) with your server hostname:

dockerstatus my-docker-host

That's it! You now have a live dashboard of your containers, refreshing automatically.

How to Use

Basic Usage

Monitor containers on a remote server:

dockerstatus server.example.com

Specify a different SSH user (defaults to root):

dockerstatus server.example.com myuser

Use with SSH config entries:

dockerstatus my-server --ssh-config

Run with sudo privileges:

dockerstatus server.example.com --sudo

Complete Command Reference

System Requirements

Docker Cluster Monitor works on any system that supports SSH and has Docker CLI tools installed on the remote server.

Tested on: Ubuntu Linux
Should work on: Most Linux distributions and Unix-like systems
Current limitation: Does not work on the local machine (remote servers only)

Want local support? Contributions welcome! PRs accepted.

About

Docker Cluster Monitor is available on PyPI as dockerclustermon. While it's published as a Python package, it's designed as a standalone CLI tool rather than a library to import into your programs.