74 lines
2.4 KiB
Markdown
74 lines
2.4 KiB
Markdown
# 🧹 Docker Volume Cleaner
|
||
[](https://github.com/sponsors/kevinveenbirkenbach) [](https://www.patreon.com/c/kevinveenbirkenbach) [](https://buymeacoffee.com/kevinveenbirkenbach) [](https://s.veen.world/paypaldonate)
|
||
|
||
|
||
**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](https://github.com/kevinveenbirkenbach/package-manager) with the alias:
|
||
|
||
```bash
|
||
pkgmgr install dockreap
|
||
```
|
||
|
||
> `dockreap` is the alias for this tool within `pkgmgr`.
|
||
> Repository: [github.com/kevinveenbirkenbach/docker-volume-cleaner](https://github.com/kevinveenbirkenbach/docker-volume-cleaner)
|
||
|
||
---
|
||
|
||
## 🧪 How to Use
|
||
|
||
```bash
|
||
# 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]([https://chat.openai.com/share/7b177eef-b97f-4e63-b2ef-cfdc69c2337e](https://chatgpt.com/share/67f3c910-2ea0-800f-85db-71ec39a713f2)) 🤝
|
||
|
||
---
|
||
|
||
## 👤 Author
|
||
|
||
**Kevin Veen-Birkenbach**
|
||
🌍 [https://www.veen.world/](https://www.veen.world/)
|