fdupes Container

A minimal containerized version of fdupes, a command-line utility for finding duplicate files on your filesystem.

Overview

This container provides a secure, minimal environment for running fdupes without installing it directly on your host system. It's built on Ubuntu Rolling and runs as a non-root user for enhanced security.

Usage

Basic Usage

# Run fdupes on a directory
docker run --rm -v /path/to/search:/data code.billie.codes/utility-container-fdupes:latest /data

# Run with recursive search
docker run --rm -v /path/to/search:/data code.billie.codes/utility-container-fdupes:latest -r /data

# Show sizes of duplicates
docker run --rm -v /path/to/search:/data code.billie.codes/utility-container-fdupes:latest -S /data

Advanced Usage

# Interactive deletion of duplicates
docker run --rm -it -v /path/to/search:/data code.billie.codes/utility-container-fdupes:latest -d /data

# Custom command with fdupes options
docker run --rm -v /path/to/search:/data code.billie.codes/utility-container-fdupes:latest --help

Container Features

• Minimal Size: Based on Ubuntu Rolling with only essential packages
• Security: Runs as non-root user (UID/GID 1568)
• Latest fdupes: Always installs the latest version from Ubuntu repositories
• Clean: No package manager cache or unnecessary files

Build & Security

The container includes automated CI/CD with:

• Security Scanning: Trivy vulnerability scanning
• Linting: Hadolint Dockerfile best practices
• SBOM Generation: CycloneDX software bill of materials
• Optional Signing: Cosign image signing and attestation

Build from Source

git clone https://code.billie.codes/utility-container-fdupes.git
cd utility-container-fdupes
podman build -t fdupes:latest .

fdupes Options

The container exposes all fdupes functionality. Common options include:

• -r - Recursive directory search
• -S - Show sizes of duplicates
• -d - Delete duplicates interactively
• -n - No prompt (use with caution)
• -f - Exclude empty files
• -1 - List only one copy of each duplicate

For complete usage information:

docker run --rm code.billie.codes/utility-container-fdupes:latest --help

License

This project is released under the Unlicense (Public Domain). See LICENSE.md for details. This does not cover any packaged applications, which are included unmodified and are subject to their own licenses.

Repository

• Source: https://code.billie.codes/utility-container-fdupes
• Container Registry: code.billie.codes/utility-container-fdupes:latest