Ferrite is a single-binary agent that watches a local path and mirrors changes to any S3-compatible bucket. No database, no daemon registry, no cloud account required.
curl -fsSL https://get.ferrite.sh | sh
ferrite init --bucket my-bucket --endpoint s3.example.net| Key | Default | Description |
|---|---|---|
watch.interval | 2s | Filesystem poll interval when inotify is unavailable |
upload.parallel | 4 | Concurrent multipart uploads |
retry.backoff | exponential | Retry strategy for failed parts |
cache.dir | ~/.ferrite | Local chunk cache location |
The agent exposes /api/health for liveness checks and streams progress events over the local socket. See the documentation for the full endpoint list.