Purpose
Mirror files from a mounted drive on the Relayer host up to a bucket, continuously.
Two modes: Backup (local copy stays) and Archive (local copy is purged once
it’s safely in the cloud).
When you use it
- Camera/DVR footage, exports, or drop-folders that should flow to cloud storage
automatically. - Freeing local disk by archiving cold files off the machine.
Prerequisites
- A drive mounted via Disk Management. The Add Source button
is disabled until at least one drive is mounted. - A target bucket.
Controls
Register New Source form (opened with Add Source)
- Name — required; locked once the source exists, so it cannot be renamed on edit.
- Mode — Backup (cloud copy only) or Archive (cloud copy + purge).
- Local Directory — a dropdown of mounted drives, or a free-text path when no
drives are detected. - Target Bucket — a dropdown of your buckets, or a free-text name as a fallback.
- Sync Interval (seconds) — default 300.
- Min File Age (minutes) — default 5; files younger than this are skipped so
half-written files aren’t uploaded. - Bandwidth Limit — free-text; a value like fifty megabytes, or 0 for unlimited.
- Purge Age (days) and Purge Size Threshold (GB) — shown only in Archive mode;
they govern when the local copy is purged. - File Patterns — comma-separated globs; blank means all files.
- Register (new) or Update (edit), plus Cancel.
Register confirmation — registering a new source opens a confirm dialog that names
the directory and bucket and shows a best-effort volume estimate (files and size)
before it starts copying. Editing an existing source skips this step.
Sources table — each configured source shows Name, Mode, State, Progress, Last
Sync, Files, Size, and a row of actions:
- Pause / Resume — halt or restart the sync loop.
- Trigger Sync — run a sync pass now.
- Restore — pull a single file back down from the cloud by its relative path.
- Edit — reopen the form for that source.
- Delete — stop and remove the source; asks for confirmation.
Sources rejected at load (bad config) are listed in a separate table with the reason.
Common tasks
- Archive camera footage: mount the drive → Add Source → Mode = Archive →
directory + bucket → keep the 5-minute file age (recorders write in place) →
Register → confirm. - Force an immediate copy: find the source → Trigger Sync.
- Pull one file back: find the source → Restore → enter the file’s relative path.
Gotchas
- Archive mode deletes the local copy after upload — that’s its job. Use Backup
if you’re not certain. - Min File Age is your safety net against syncing files still being written; don’t
set it to 0 for actively-written directories. - A source can’t be renamed after registration — the Name field is locked on edit.
Screenshots
