> Personal Dropbox, More Cuddly

Dropbear keeps a local folder in sync with an S3-compatible bucket. One CLI binary + Bring Your Own Bucket (BYOB) — Cloudflare R2, MinIO, Backblaze B2, AWS S3, whatever speaks the protocol.

If you came here wondering what this thing is and whether it's worth your time, start here:

- [**Why does this exist?**](/why) — the elevator pitch, and what Dropbear is _not_
- [**Use cases**](/use-cases) — the modes a root can run as
- [**Who is this for?**](/audience) — the assumed user
- [**Setup**](/setup) — rough sketch of how to get a root running (pre-1.0; expect this to change)
- [**Trade-offs**](/trade-offs) — what got picked, what got given up, and why
- [**Failure modes**](/failure-modes) — what breaks, what it looks like, what you do

## At a Glance

```shell
$ dropbear init --root-id photos --device-id laptop --mode bidirectional \
    --remote-bucket my-bucket --remote-endpoint https://abc.r2.cloudflarestorage.com \
    ~/Pictures
$ dropbear sync ~/Pictures
synced ↓0 (0 bytes) ↑42 (18394821 bytes) ⊘0 ✗0 ⚠0 → 20260526T142301Z_a1b2c3d4
```

On a second machine, init the same `root_id` with a different `device_id`, run `restore --from laptop`, and the two devices converge on `sync`.

## Status

Pre-1.0. v0.2 ships bidirectional sync, conflict files, explicit tombstones, and sync modes. v0.3 is daemon mode, filesystem watcher, and a local status API. v1.0 is when the bootstrap story stops being rough.