Relaywright

Free self-hosted SMTP relay gateway

Relaywright

Run a narrow, auditable relay for printers, scanners, line-of-business apps, and internal systems that need to send mail through one controlled upstream smart host.

Relaywright dashboard showing the production-readiness checklist

Operational control

Built for known devices, not open relay exposure

Relaywright focuses on the quiet work system engineers need from an internal SMTP relay: accept only what should be accepted, keep accepted messages durable, and make delivery state visible.

Trusted device intake

Allow SMTP submission by IP or CIDR, with owner, location, sender, recipient, size, and rate policy summaries.

Durable queue

Accepted DATA is written to disk before SMTP success. Operators can inspect age, attempts, retry schedule, and failure category.

Upstream delivery

Relay to one upstream smart host with TLS settings, optional basic authentication, or Microsoft OAuth client credentials.

Diagnostics

Run connectivity checks, submission-flow previews, and test email diagnostics before pointing devices at the relay.

Backups and restore staging

Create SQLite backups, validate restore readiness, review retention, and stage restores with clear restart impact.

Security visibility

Review admin sign-in events, current session details, suspicious login warnings, HTTPS certificate status, and account recovery guidance.

First 15 minutes

Install, prove, then point devices at it

Use the admin UI to finish configuration before any production device starts sending through Relaywright.

  1. 1

    Install the service

    Use the Windows installer or Linux install script for v1.1.0.

  2. 2

    Create the first admin

    Open the local admin URL and complete first-run setup.

  3. 3

    Configure upstream SMTP

    Set the smart host, TLS behavior, timeout, and authentication mode.

  4. 4

    Add trusted devices

    Allow only the source IPs or CIDRs that should submit mail.

  5. 5

    Run diagnostics

    Check connectivity, preview submission policy, and send a test email.

  6. 6

    Switch traffic deliberately

    Point one device at the relay, confirm queue and delivery history, then expand.

Admin console

Operator views for day-two work

Dashboard overview showing production-readiness checks for the relay
Dashboard A practical readiness checklist before production devices start sending.
Trusted devices table showing CIDR rules, owners, locations, and rate limits
Trusted devices Source IP/CIDR allow rules with sender, recipient, and rate policy context.
Queue table showing retry state, senders, recipients, attempts, and errors
Queue review State, age, attempts, retry schedule, and delivery history in one place.
Flow Checker showing a successful trusted-device submission policy evaluation
Diagnostics Connectivity, flow-check, and test-mail stages before production traffic.
Backups page showing ready restore status and a recently validated backup
Backup readiness Validated restore points, retention, and recovery status at a glance.

Security model

Narrow intake and auditable operations

No open relay posture

SMTP submission is constrained by trusted IP or CIDR rules before message content is accepted.

Durability before success

Accepted DATA is durably spooled and queue metadata is saved before clients receive SMTP success.

Protected admin surface

Production installs are HTTPS-first, with admin HTTP disabled unless deliberately enabled.

Secret-aware operations

Relay secrets are protected at rest, and diagnostics avoid storing message bodies, passwords, tokens, or private SMTP transcripts.

Validated release line

Windows and Linux packages

Release builds are self-contained. The target machine does not need a separate .NET runtime.

Windows x64 Installer and service validation
Linux x64 systemd install and update validation
Linux ARM64 Clean-install validation
SMTP smoke Trusted and untrusted submission checks

Install

Download Relaywright v1.1.0

Use the release artifacts and verify them with SHA256SUMS.txt before installing on production hosts. The latest release page always points at the current stable build.

Linux

The installer selects x64, ARM64, or ARMv7 packages automatically.

curl -fsSL https://github.com/dotwebster-development/Relaywright/releases/download/v1.1.0/install-relaywright.sh \
  -o install-relaywright.sh
sudo bash install-relaywright.sh --repo dotwebster-development/Relaywright --version 1.1.0

To track the current stable version after reviewing release notes, use --repo dotwebster-development/Relaywright --version latest.