🧹 Docker Volume Cleaner

Docker Volume Cleaner is a lightweight Python tool that helps you identify and remove unused anonymous Docker volumes — including symlinks and their targets 🗑️

Keep your Docker environment tidy, automated, and efficient 🚀

⚙️ Features

Detects all anonymous Docker volumes (64-character hashes)
Skips whitelisted volumes
Skips bootstrap mounts (/var/www/bootstrap)
Cleans up symlinks and their target directories
Optional confirmation prompt via --no-confirmation
Pure Python — no dependencies

📦 Installation

Install it using Kevin’s Package Manager with the alias:

pkgmgr install dockreap

dockreap is the alias for this tool within pkgmgr.
Repository: github.com/kevinveenbirkenbach/docker-volume-cleaner

🧪 How to Use

# Basic usage with confirmation prompt
dockreap

# Skip confirmation
dockreap --no-confirmation

# Skip specific volumes by adding them to the whitelist
dockreap "volumeid1 volumeid2"

# Skip confirmation + whitelist
dockreap "volumeid1 volumeid2" --no-confirmation

📝 Notes:

Only volumes with 64-character hash names (anonymous volumes) are considered.
Volumes mounted at /var/www/bootstrap are automatically excluded.
If a volume directory is a symlink, both the symlink and its target are removed.

📜 License

This project is licensed under the MIT License.

🤖 Built with ChatGPT

Developed with the help of ChatGPT 🤝

👤 Author

Kevin Veen-Birkenbach
🌍 https://www.veen.world/

1.9 KiB Raw Blame History Unescape Escape