1
0
Fork 0
mirror of https://github.com/hyvor/relay.git synced 2026-04-25 21:45:49 +03:00
No description
Find a file
Sakith B. 9f06bb6d58
OIDC with organization update (#421)
* wip

* update hyvor/internal

* frontend

* test fixes

* test

* phpstan

---------

Co-authored-by: SupunKavinda <supunkavinda1125@gmail.com>
2026-04-13 15:35:19 +05:30
.github fix: minor bugs (#380) 2025-12-06 04:38:44 +01:00
backend OIDC with organization update (#421) 2026-04-13 15:35:19 +05:30
benchmark benchmark.js (#283) 2025-09-27 23:55:36 +05:30
deploy Caddyfile, setup docs refactor (#372) 2025-12-01 04:35:28 +01:00
frontend OIDC with organization update (#421) 2026-04-13 15:35:19 +05:30
meta Caddyfile, setup docs refactor (#372) 2025-12-01 04:35:28 +01:00
worker forward SMTP sends synchronously and return errors (#414) 2026-03-05 11:17:34 +01:00
.dockerignore Document web/instance domain changes (#356) 2025-11-30 12:11:46 +01:00
.editorconfig SMTP Interface (#337) 2025-11-16 03:25:15 +01:00
.gitignore Docs (#332) 2025-11-16 03:25:26 +01:00
compose.yaml OIDC with organization update (#421) 2026-04-13 15:35:19 +05:30
dev-testing-mail.md Document web/instance domain changes (#356) 2025-11-30 12:11:46 +01:00
Dockerfile forward SMTP sends synchronously and return errors (#414) 2026-03-05 11:17:34 +01:00
LICENSE Create LICENSE 2025-06-06 15:41:00 +02:00
README.md Docs (#332) 2025-11-16 03:25:26 +01:00
ROADMAP.md Instance domain and Web URL from .env (#341) 2025-11-21 04:53:23 +01:00

Hyvor Relay

Hyvor Relay is a self-hosted, open-source email API for developers. It uses SMTP to send emails using your own infrastructure. It is designed to be simple to self-host, easy to manage and observe, and powerful enough to send millions of daily emails.

Hyvor Relay Logo

Email API for Developers | Self-Hosting Docs | Product Docs

Features

  • Self-Hosted: Docker compose or swarm-based deployment.
  • Health Checks: Multiple health checks to ensure best performance and deliverability.
  • Email API: Send emails using a simple API.
  • Logs & SMTP Conversations: View send logs and SMTP conversations of sent emails up to 30 days.
  • Multi-Tenancy: Support for multiple tenants with scoped access (useful for organizations and agencies).
  • Project Management: Support for multiple isolated projects within a tenant.
  • Queues: Two main queues to isolate transactional and distributional emails and IP reputation.
  • Greylisting & Retries Handling: Automatically manage greylisting and retries.
  • Bounce Handling: Automatically handle bounced emails.
  • Feedback Loops: Integrate with feedback loops to manage spam complaints.
  • Suppressions: Automatically manage email suppressions (bounces, unsubscribes, etc.).
  • DNS Automation: Delegate DNS to the in-built DNS server. No need to manage DNS records manually.
  • Webhooks: Receive HTTP callbacks for email events.
  • Easy scaling: Add more servers and IP addresses as needed.
  • Observability: Prometheus metrics, Grafana dashboards, and logs for monitoring.

Screenshots

The sudo dashboard for admins:

Sudo Dashboard

The console for users (viewing send logs and SMTP conversations):

User Console

Architecture

  • PHP + Symfony for the API backend.
  • Go for email workers, webhook handlers, DNS server, and the incoming SMTP server.
  • SvelteKit and Hyvor Design System for the frontend.
  • PGSQL is used for the database as well as for the queue.

Roadmap & Community

Contributing

Visit hyvor/dev to set up the HYVOR development environment. Then, run ./run relay to start Hyvor Relay at https://relay.hyvor.localhost.

Directory structure:

  • /backend: Symfony API backend
  • /frontend: SvelteKit frontend
  • /worker: Go services (single binary)

License

Hyvor Relay is licensed under the AGPL-3.0 License. We also offer enterprise licenses for organizations that require a commercial license or do not wish to comply with the AGPLv3 terms. See Self-Hosting License FAQ for more information.

HYVOR Banner

Copyright © HYVOR. HYVOR name and logo are trademarks of HYVOR, SARL.