Operations

Diagnostics and support bundles

Use RelayBridge diagnostics to separate service, listener, queue, Microsoft, certificate, storage, and connectivity evidence, then review a sanitized local support bundle.

v1.0.0-rc.1 ยท PreviewUnsigned public release candidate for evaluation and community testing. A signed stable release is not yet available.Release status

Read evidence by source

Diagnostics reports Healthy, Needs attention, Unavailable, Not configured, or Unknown rather than collapsing unrelated state into one boolean.

  • service version, build, uptime, operating system, runtime, and hosting mode;
  • SMTP listener state, actual binding, mode, enabled devices, and last local acceptance;
  • queue counts, oldest message, next retry, and worker state;
  • persisted and current-process Microsoft readiness;
  • certificate presence, private-key accessibility, validity, and expiry;
  • the last sanitized Microsoft setup stage, substage, category, and code;
  • storage availability, schema, free space, and SQLite quick-check evidence; and
  • management, LAN SMTP, tooling, certificate, and setup-scratch boundaries.

Choose the correct check

ActionWhat it checksWhat it does not do
Run connectivity checksDNS, TCP 587, SMTP greeting, EHLO, STARTTLS, and certificate-validated TLSAcquire a token, authenticate, mutate the tenant, or submit mail
Database quick checkSQLite PRAGMA quick_checkEdit, vacuum, or recreate the live database
Microsoft Verify connectionActive certificate, token acquisition, TLS, XOAUTH2, and QUITProvision the tenant, activate a candidate, or send a mail transaction
Repair connectionThe controlled Microsoft identity and RBAC repair flowReplace Windows Installer repair or justify broad permissions

Generate and review a support bundle

RelayBridge creates the ZIP locally and does not upload it. Bundle schema v1 uses a fixed allowlist and a 1 MiB compressed-size cap.

The implemented exclusions cover raw configuration, database files, logs, spool files, message content, mailbox addresses, device credentials and verifiers, OAuth tokens, private keys, certificate references, and detailed raw setup output.

Review before sharing

The bundle still includes operational metadata such as versions, timestamps, counts, listener and network information, storage capacity, and sanitized status summaries. Review it for your environment before attaching it to any report. Sanitization reduces risk; it is not a guarantee that sensitive information can never appear under every defect or environmental condition.

Report the problem safely

Use GitHub Issues for reproducible non-security defects. Do not publish tenant identifiers, mailbox or message data, credentials, tokens, certificates, private keys, raw configuration, databases, spool files, or an unreviewed support bundle.

Report suspected vulnerabilities through the repository's private security-reporting process described in SECURITY.md.