rafaelqsantosrqs/docker-cleanup repository overview

⁠🧹 Docker Cleanup Tool

An automated, lightweight, and professional Go utility designed to keep your Docker environment lean and efficient. It safely removes unused resources without interrupting your active containers.

⁠✨ Key Features

• ✅ Container Management: Automatically identifies and removes stopped containers.
• ✅ Volume Pruning: Safely reclaims disk space by deleting orphan volumes.
• ✅ Network Cleanup: Removes unused Docker networks.
• ✅ Image Optimization: Prunes dangling and unused images (while preserving those in use).
• ✅ Daemon Mode: Can run as a persistent background service with configurable intervals.
• ✅ Cloud Ready: Fully Dockerized and OCI-compliant.

⁠🚀 Getting Started

⁠🐳 Option 1: Docker (Recommended)

The most portable way to run the tool. Ideal for servers and CI/CD environments.

One-shot run:

docker run --rm -v /var/run/docker.sock:/var/run/docker.sock rafaelqsantos/docker-cleanup

Running as a Daemon (Background Service):

docker run -d \
  --name docker-cleanup \
  -e CLEANUP_INTERVAL=24h \
  -v /var/run/docker.sock:/var/run/docker.sock \
  rafaelqsantos/docker-cleanup

⁠💻 Option 2: Pre-compiled Binaries

Download the latest binaries for your platform from the Releases⁠ page.

# Example for Linux
./docker-cleanup-linux-amd64

⁠🛠️ Option 3: Developer Setup

If you prefer running from source:

git clone https://github.com/rafael-qsantos/Management-go.git
cd Management-go
go run main.go

⁠⚙️ Configuration

Control the behavior of the tool using environment variables:

⁠🤖 CI/CD Automation

This project is fully automated via GitHub Actions:

• Automated Releases: Every version tag (v*) triggers a multi-platform binary build.
• Docker Publishing: Every release is automatically pushed to Docker Hub with latest and version tags.

⁠📝 License

Distributed under the MIT License. See LICENSE for more information.

Built with ❤️ by Rafael Queiroz Santos