Skip to content

mattmolo/docker-info

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Docker Info (di)

Docker info is a small utility that emulates docker ps, but with better grouping, cleaner port information, and a nicer layout. I manage my homelab with multiple docker compose stacks, and I wanted something nicer to get the status of all docker containers.

Pull requests and issues are welcome, but I make no guarantees on responding quickly.

Features

  • Project Grouping: Automatically groups containers by their Docker Compose project.
  • Smart Sizing: Detects terminal width and trims long names to prevent wrapping.
  • Color-Coded Status: Colorize Up, Exited, or Restarting containers.
  • Clean Ports: Port information is hidden by default and simplified when shown (compacts redundant IPv4/IPv6 mappings).
  • Fast: Built in Go using the official Docker SDK for direct docker.sock communication.

Usage

# Basic view
./docker-info

# Show port mappings
./docker-info -p

Installation

Prerequisites

  • Docker installed and running.
  • Go 1.26+ (if building from source).

Building

make build

System-wide Install

sudo make install

Configuration

The utility should respect standard Docker environment variables (e.g., DOCKER_HOST).

About

Small utility for showing the status of your docker containers

Resources

License

Stars

Watchers

Forks

Contributors