liquidlogiclabs/Docker Registry Cleanup

Delete untagged/tagged images from container registries. Supports GHCR, Gitea, Docker Hub, and any OCI-compliant registry (Harbor, Quay.io, ACR, etc.).

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stale
License
None
namedescriptionrequireddefault
registry-typeRegistry type: ghcr, gitea, docker-hub, docker, oci, or autoyes
registry-urlRegistry base URL (required for gitea, docker, and auto; optional for ghcr/docker-hub)no
registry-usernameRegistry username (optional, for Docker Hub and docker CLI provider)no
registry-passwordRegistry password (optional, for Docker Hub and docker CLI provider, alternative to token)no
tokenAuthentication token (registry-specific)no${{ github.token }}
ownerRepository owner (optional, defaults to current repo owner)no
repositoryRepository name (optional, defaults to current repo name)no
packagePackage name to clean (can be used instead of packages)no
packagesComma-separated list of packages to cleanupno
expand-packagesEnable wildcard or regular expression support on the package(s) optionnofalse
use-regexUse regular expression for package matchingnofalse
dry-runSimulate cleanup without deletingnofalse
keep-n-taggedKeep N latest tagged imagesno
keep-n-untaggedKeep N latest untagged imagesno
delete-untaggedDelete all untagged imagesnofalse
delete-tagsDelete specific tags (wildcard/regex supported)no
exclude-tagsExclude tags from deletionno
older-thanDelete images older than specified time (e.g., "30d", "2w", "1m")no
delete-ghost-imagesDelete ghost imagesnofalse
delete-partial-imagesDelete partial multi-arch imagesnofalse
delete-orphaned-imagesDelete orphaned imagesnofalse
validateValidate multi-arch images after cleanupnofalse
retryRetry count for API callsno3
throttleThrottle delay between API calls (milliseconds)no1000
skip-certificate-checkSkip TLS certificate verification for registry API callsnofalse
verboseEnable verbose debug logging. Also enabled when ACTIONS_STEP_DEBUG=true.nofalse
namedescription
deleted-countNumber of images/packages deleted
kept-countNumber of images/packages kept
deleted-tagsList of deleted tags (comma-separated)
kept-tagsList of kept tags (comma-separated)