docker-environment-inspector

A FastAPI app that connects to the local Docker daemon and exposes a JSON summary of containers, volumes, and images, plus a tiny browser UI.

Key features

• Lists all containers with status, image tags, and ports
• Marks named volumes as orphaned if they are not mounted by any container
• Counts local images
• Docker Compose and Dockerfile included

Project structure

• app.py — FastAPI app and Docker SDK integration
• Dockerfile — Container image build
• docker-compose.yml — Runs the app with /var/run/docker.sock mounted

Requirements

• Docker and Docker Compose
• Access to /var/run/docker.sock

Setup

git clone https://github.com/biprajit007/docker-environment-inspector.git
cd docker-environment-inspector
docker compose up --build

Usage

Open dashboard

http://localhost:18080/

Fetch JSON summary

curl http://localhost:18080/api/summary

Safety notes

• Mounting the Docker socket gives the container broad control over the Docker host. Use only on trusted systems and networks.

Limitations / next improvements

• Read-only in the current code, but the mounted socket is still sensitive
• No authentication or pagination
• Large Docker environments may produce large JSON responses