Uploads overview
Ref vs URL mode
| Mode | Wire placeholder | Host requirement |
|---|---|---|
ref (default) | { "__qaFileRef": "<uploadId>" } | In-memory upload store: enable upload on bootstrap / startInspectorWebSocket / attachCatRPC. |
url | { "__qaFileUrl": "https://…" } | Configure fileUrl with a non-empty allowedHosts allowlist. Tenant/admin UI uploads to your host route, then sends HTTPS URLs on the wire. |
validateBootstrapFileWire enforces fileUrl.allowedHosts when qaFileWire.mode === 'url'.
Host Minio
Host-only credentials stay in process memory — see Host Minio.