docker-overlay-cleanup

Interactive TUI tool to find and clean orphaned Docker overlay2 folders.

The Problem

/var/lib/docker/overlay2 can grow large with orphaned layer folders that aren't referenced by any container or image. Even after running docker system prune, some folders may remain.

What This Does

Scans all folders in /var/lib/docker/overlay2
Maps each folder to its container/image using docker inspect
Identifies orphans (folders not referenced by anything)
Provides an interactive TUI to select and delete them

Usage

# Clone
git clone https://gitea.olex.me/clawd/docker-overlay-cleanup.git
cd docker-overlay-cleanup

# Run (requires root for Docker access)
sudo python3 docker-overlay-cleanup.py

TUI Keybindings

Key	Action
`↑↓` / `jk`	Navigate
`Space`	Toggle selection
`o`	Select all orphans
`c`	Clear selection
`a`	Toggle show all / orphans only
`Enter`	Delete selected (with confirmation)
`q` / `Esc`	Quit

Screenshot

 Docker overlay2 Cleanup | Orphans: 12 (4.2 GB) | Selected: 0 (0 B) [ORPHANS ONLY]
 ↑↓:nav | Space:select | a:toggle-all | Enter:delete-selected | q:quit

 [ ]     1.2 GB  a1b2c3d4e5f6...  ORPHAN
 [ ]   800.0 MB  f6e5d4c3b2a1...  ORPHAN
 [ ]   500.0 MB  1234567890ab...  ORPHAN
 ...

Requirements

Python 3.6+
Docker
Root access (sudo)
No external Python dependencies (uses curses from stdlib)

License

MIT