gabriellhl/rsync repository overview

⁠Rsync Utility Docker Image

⁠Overview

This image provides a minimal rsync runtime environment based on Alpine Linux, with the required tooling to perform file synchronization over SSH.

It is designed for:

• One-shot rsync jobs
• Scheduled sync tasks (cron / external scheduler)
• Infrastructure orchestration containers
• NAS → server or server → server sync workflows

This is a utility image, not an application runtime.

⁠Included Components

⁠Why Alpine + Bash

Alpine is chosen for:

• Small image size
• Fast startup
• Minimal attack surface

bash is explicitly installed because:

• Sync scripts often rely on bash features
• POSIX sh is insufficient for non-trivial logic
• Script portability and predictability matter more than minimalism

⁠Intended Use Cases

This image is suitable for:

• Rsync-based backup or mirroring jobs
• Containerized sync tasks triggered by schedulers
• Stateless data transfer containers
• Shared infrastructure scripts across environments

It is not intended for:

• Long-running services
• Application runtimes
• General-purpose debugging environments

⁠Example Usage

⁠One-shot rsync job

docker run --rm \
  -v /local/data:/src:ro \
  -v /local/ssh:/root/.ssh:ro \
  gabriellhl/rsync:alpine3.19 \
  rsync -av /src/ user@remote:/dst/