# Docker Cleanup

Docker Cleanup is a self-hosted infrastructure app. An Unraid plugin for self-hosters that reclaims disk space by pruning unused Docker images on your chosen schedule, notifying you of the space recovered, and manually removing confirmed leftover Docker volumes. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/4201/docker-cleanup

## Description

An Unraid plugin for self-hosters that reclaims disk space by pruning unused Docker images on your chosen schedule, notifying you of the space recovered, and manually removing confirmed leftover Docker volumes.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

41/100 (Fair), based on 3 of 4 factors.
- Maintained: 74 (last commit 41 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)

## Links

- GitHub: https://github.com/Yoshiofthewire/Unraid_Docker_Cleanup
- Unraid: https://ca.unraid.net/apps/docker-cleanup-051ks3y0thku8q?q=Docker%20Cleanup

## Common questions

### How do I install the Docker Cleanup plugin and where are its settings?

In Unraid, open Settings > Plugins > Install Plugin and paste the .plg URL from the GitHub README. The settings appear under Settings > User Utilities > Docker Cleanup.

### Will unused but kept Docker images be removed by the scheduled cleanup?

Yes. The scheduled run uses docker image prune -a -f, deleting every image not referenced by a running or stopped container. Those images are re-pulled when needed again.

### Does Docker Cleanup delete unused volumes automatically, and how are named volumes handled?

Volumes are never deleted on a schedule; the manual action only removes volumes you confirm after showing the list. Named volumes are excluded unless you enable include named volumes, and anonymous detection uses a 64 lowercase hex-character name heuristic.

### What custom cron formats does the schedule field accept?

It accepts only five numeric fields for minute, hour, day of month, month, and day of week. Names and shortcuts such as MON, JAN, @daily, or @reboot are rejected.

### Does the scheduled run report how much space was freed?

Yes. It sends an Unraid notification with the space reclaimed after the scheduled image prune.

---
Source: Our Local Host (https://ourlocalhost.com/app/4201/docker-cleanup), the self-hosted and open-source app directory.
