Kevin Veen-Birkenbach 76cfa5312d Optimized How to Use
2025-04-07 14:56:04 +02:00
2025-04-07 14:40:00 +02:00
2025-04-07 14:56:04 +02:00
2025-04-07 14:56:04 +02:00

🧹 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 Kevins 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/

Description
A Python tool to safely detect and remove unused anonymous Docker volumes. Supports whitelisting, symlink cleanup, and optional confirmation prompts. Ideal for keeping your Docker environment clean and efficient.
Readme MIT 60 KiB
Languages
Python 93.4%
Makefile 6.6%