Purpose
The box’s operational settings in three tabs: the install’s S3 credentials, the
storage services and their tuning knobs, and local database backups.
Credentials tab
- Cost Center — dropdown identifying the billing account this Relayer’s usage is
charged to; one entry is labelled Primary Account, and an info tooltip links to the
billing console. Once set, a cost center cannot be cleared from the UI — only by
emptying the cost center field in the Relayer configuration file on the box. - Relayer URL — the S3 endpoint clients should use, with a copy button.
- Access Key / Secret Key — the install’s root S3 credential; the secret has
reveal and copy. - Rotate Credentials — after a confirm dialog, invalidates the old pair and mints a
new one. The new secret is shown only once, so copy it immediately.
Tasks & gotchas
- Rotating breaks every client still using the old pair — update them immediately.
- Prefer scoped IAM credentials for tools; keep the root
pair for administration.
Services tab
- Status rows for HostIO, Gateway, and S3 Gateway — each a colored dot with
a Running or Stopped state. - Auto Startup toggle and Restart All, side by side.
- S3 Gateway Port — gateway-wide; applies to all buckets and presigned URLs. Saving
a new port opens a confirm dialog warning that existing presigned URLs stop working. - When you change any advanced setting or the cost center, an Apply Changes bar
appears at the top of the page. A Restart required flag shows when applying will
restart HostIO or Gateway, interrupting in-flight transfers.
Advanced settings (five groups)
- Upload Throughput (9): upload workers · download workers · simultaneous
uploads (auto-tuned to your connection, e.g. “Auto — 172 connections”) · utility
workers · simultaneous downloads from hosts · max connections · upload retries ·
inactivity period before non-flushed files are marked stale · file cleanup period. - Cache & Read Behavior (7): maximum cache size · download speed-vs-cost
priority (0 = fastest) · cache pressure threshold · max sleep under cache
pressure · free cache target · max eviction size · cache only data that has been
read (skip downloaded/restored). - Memory Pressure (2): force garbage collection · GC memory limit.
- Provider Relationship (2): retry interval for host-set retrieval at startup ·
background check interval for host-set updates. - Diagnostics (2): logging level and log level (trace…panic).
Tasks & gotchas
- The defaults are auto-tuned; change advanced values one at a time and note what
you changed. “Auto” beats guesswork for simultaneous uploads. - Changing the S3 Gateway port changes every client’s endpoint and invalidates
previously-issued presigned URLs’ port. - Debug/trace logging is for short diagnostic windows, not steady state.
Backup tab
- Titled Relayer Backup. A Local Database toggle (on by default) and an
Automatic Backups toggle sit at the top. Turning Local Database off reveals
external Postgres connection fields — host, port, database, user, password, and SSL
mode. - Automatic-backup schedule: Frequency (30, 60, 90, or 120 minutes, Daily, or
Weekly), size Threshold in GB, and Retention as a number of backups kept. - Backup Now and a table of existing backups with File, Created, and Size columns;
each row has Download, Restore, and Delete actions.
Tasks & gotchas
- This protects the Relayer’s local database (metadata/config) — it is not a backup
of your stored objects, which live sharded across the provider network. - Before risky maintenance: Backup Now first.
Screenshots
