Skip to content

Console screens

A tour of the Custos operator console (the admin companion app). Every image here is generated automatically from the app’s own browser test harness across named scenarios, including a degraded relay, so the pictures track the real UI and cannot quietly drift.

The console opens on the active relay, ready to mint a single-use, device-signed account claim code. A Relay federation block up top reports whether the upstream relay is actually crawling this server (status, exact events behind, last seen) with a Request crawl re-invite (see Is the upstream relay seeing you?).

Custos console home screen with a Relay federation readout and a claim-code mint action
Home: the relay-federation readout, then mint a single-use, device-signed claim code for the active relay.

Before any relay is paired, the console asks you to pair this operator device.

Custos console home screen before pairing, offering 'Pair this device'
Before pairing: no relay is bound to this operator device yet.

Pair a device with a relay by QR or manual entry.

Custos console pair screen with QR and manual entry
Pair with a relay by QR or manual entry.

Every account on one relay, searchable by handle or DID, with a per-row blob-quota readout.

Custos console accounts list with search and per-row quota bars
Every account on one relay, searchable, with per-row blob quota.

The claim-code inventory splits live credentials from terminal history.

Custos console claim-code inventory
Outstanding claim codes and their terminal history.

Every admin device registered on one relay — active and revoked — with a remote revoke for a lost device.

Custos console devices list with remote revoke
Admin devices on one relay, with remote revoke for a lost device.

Account takedown and restore, then credential revocation — each an armed, biometric-gated destructive action.

Custos console moderation screen for account takedown and restore
Account takedown/restore and credential revocation, each armed and gated.

Every privileged operator action (takedowns, credential sweeps, code mints and revokes, device pairings and revocations, transfer cancels, account repairs, crawl requests) is durably recorded with the credential that signed it: the master token or the specific paired device. The Audit screen browses the trail reverse-chronologically, filterable by action, with per-event drill-in by actor or subject.

Custos console audit log listing admin actions with action filters and outcome chips
Every privileged admin action, newest first, attributed to the credential that signed it.

In-flight device transfers an operator can watch and cancel.

Custos console transfers list
In-flight device transfers an operator can watch and cancel.

One relay’s health as it reports it: version and uptime, account counts, blob and block totals, firehose state, and background-sweep last-runs. Facts only; nothing here is a verdict.

Custos console server status readout
One relay's health as it reports it — facts only.

On a degraded relay, a troubled background sweep is flagged with a trailing ! glyph and a named fault: stale when its passes have stopped completing (the sweep is dead), or failed <n> when a pass ran but recorded n errors (for blob GC, an account whose reconcile failed is skipped, so its blobs stay uncollected, and its disk unreclaimed, until the fault is fixed). Naming each fault keeps the two legible apart on a row that carries both; status is never signaled by color alone.

Custos console server status for a degraded relay with stale-sweep glyphs
A degraded relay: stale sweeps flagged by glyph, never color alone.

Per-relay pairings, the global admin key, and the biometric toggle.

Custos console settings with per-relay pairings
Per-relay pairings, the global admin key, and the biometric toggle.

Further down, a Diagnostics section exports a redacted, per-relay network-error log for troubleshooting: operation names, relay hosts, statuses, and short error codes only, never credentials, keys, signed requests, or claim codes.

Custos console settings scrolled to the Diagnostics section with an 'Export diagnostics' button
The diagnostics export — a redacted relay-error log for handing a problem to support.