docklean

Safely find and clean unused Docker resources from the command line.

Requirements

• Node.js 18+
• Docker installed and the daemon running

Install

Run directly with npx:

npx docklean

Or install globally:

npm install -g docklean

Usage

Scan only (no deletes):

docklean

Interactive cleanup (prompts before delete):

docklean --all

Selective cleanup:

docklean --containers

Dry run (shows commands that would run):

docklean --all --dry-run

Skip prompt:

docklean --all --force

Filter by age:

docklean --images --older-than 7d

Flags

• --containers Clean stopped/exited containers
• --images Clean unused/dangling images
• --volumes Clean unused volumes
• --networks Clean unused networks
• --cache Clean build cache
• --dangling Dangling images + stopped containers + unused volumes
• --all All unused resources
• --older-than <duration> Only clean items older than m/h/d/w
• --dry-run Print what would be removed
• --force Skip confirmation prompt
• --yes Alias for --force
• --json JSON output
• --quiet Minimal output
• --verbose More verbose output
• --no-color Disable colored output

Exit Codes

• 0 Success
• 1 Docker CLI not found
• 2 Docker daemon not running
• 3 Nothing to clean or user declined
• 4 Partial failure
• 5 Invalid arguments

Development

npm install
npm run build
npm run dev -- --all --dry-run