anoniemerd/prunemate repository overview

⁠PruneMate

Docker image & resource cleanup helper, on a schedule!

⁠ ⁠

⁠PruneMate - Docker image & resource cleanup helper, on a schedule!

https://github.com/anoniemerd/PruneMate⁠

Built with Python (Flask) · Docker SDK · APScheduler · Gunicorn

Keep your Docker host tidy with scheduled cleanup of unused images, containers, networks, and volumes.

⁠✨ Features

• 🕐 Flexible scheduling - Daily, Weekly, or Monthly cleanup runs with optional manual-only mode
• 🔀 Schedule control toggle - Enable/disable automatic scheduling, so PruneMate only runs manually
• 🔍 Prune preview - See exactly what will be deleted before executing manual prune operations
• 🌍 Timezone aware - Configure your local timezone
• 🕒 12/24-hour time format - Choose your preferred time display
• 🐳 Multi-host support - Manage multiple Docker hosts from one interface (requires docker-socket-proxy on remote hosts)
• 🧹 Selective cleanup - Choose what to prune: containers, images, networks, volumes, build cache
• 🏗️ Build cache cleanup - Reclaim significant space by pruning Docker builder cache (often 10GB+)
• 📊 All-Time Statistics - Track cumulative space reclaimed and resources deleted across all runs
• 🏠 Homepage integration - Display statistics in your Homepage dashboard (works with authentication enabled)
• 🎨 Modern UI - Dark theme with smooth animations and responsive design
• 🔒 Secure authentication - Optional login protection with password hashing and Basic Auth support
• 🏗️ Multi-architecture support - Native amd64 and arm64 Docker images (Intel/AMD, Raspberry Pi, Apple Silicon)
• 🔒 Safe & controlled - Manual trigger with preview and detailed logging
• 📈 Detailed reports - See exactly what was cleaned and how much space was reclaimed

⁠Main Dashboard

The overall look and feel of the PruneMate dashboard

⁠🐳 Docker Compose :

services:
  prunemate:
    image: anoniemerd/prunemate:latest  # Supports amd64 and arm64
    container_name: prunemate
    ports:
      - "7676:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./logs:/var/log
      - ./config:/config
    environment:
      - PRUNEMATE_TZ=Europe/Amsterdam # Change this to your desired timezone
      - PRUNEMATE_TIME_24H=true #false for 12-Hour format (AM/PM)
      # Optional: Enable authentication (generate hash with: docker run --rm anoniemerd/prunemate python prunemate.py --gen-hash "password")
      # - PRUNEMATE_AUTH_USER=admin
      # - PRUNEMATE_AUTH_PASSWORD_HASH=your_base64_encoded_hash_here
    restart: unless-stopped

⁠🐳 Docker Run :

docker run -d \
  --name prunemate \
  -p 7676:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $(pwd)/logs:/var/log \
  -v $(pwd)/config:/config \
  -e PRUNEMATE_TZ=Europe/Amsterdam \
  -e PRUNEMATE_TIME_24H=true \
  --restart unless-stopped \
  anoniemerd/prunemate:latest