TS Pro Relay

Outbound email relay for hosts that block SMTP.

  • Trusted Servants Pro
  • Python

TS Pro Relay is a companion service for Trusted Servants Pro deployments that live on hosts which block outbound SMTP (DigitalOcean droplets, for example). Your app sends a simple JSON POST over HTTPS to the relay, and the relay handles the actual SMTP delivery — keeping mail credentials isolated from the application.

Features

  • Web admin interface with login, for configuration and monitoring
  • Transaction log of every send — status, recipients, subject and errors
  • Settings for the SMTP server, API-key generation, sender allowlist and attachment limits
  • Test email for quick verification
  • Optional Cloudflare Turnstile bot protection on login
  • Encrypted credentials in SQLite, plus a health-check endpoint for orchestration

Tech stack

Flask · SQLite · HTML/CSS, containerized with Docker.

Getting started

# uses the published image hyprlab/tspro-relay
mkdir tspro-relay && cd tspro-relay
# create docker-compose.yml + .env  (set a strong RELAY_SECRET_KEY)
docker compose up -d
# admin UI on port 8026 (proxy behind HTTPS in production)

Project status

Released under the AGPL-3.0 license. Companion to Trusted Servants Pro.

Follow the build

I write about self-hosting, Linux, and the tools I make. New posts land on the blog.