Introduction

Responsible Use

ThorMail is designed for high-demand professional use: transactional emails, notifications, and legitimate marketing. It is not a spam tool. Users are responsible for complying with anti-spam laws (CAN-SPAM, GDPR, etc.) and adapter terms of service.

Beta status

ThorMail is now in Beta. The documentation and system are ready for testing. Visit thormail.io to get your beta license.

Docker Images: Beta Ready

The available Docker images tagged as beta are now ready for testing. While they are more stable than alpha, we recommend caution for critical production environments. A usage license is required to run ThorMail.

ThorMail is a message delivery orchestrator designed to be the intelligent bridge between your application and any delivery adapter.

What is ThorMail?

ThorMail is much more than a simple email service. It acts as an ultra-efficient, reliable, and intelligent relay that manages the “last mile” of delivery through your chosen providers.

Note

ThorMail does not deliver messages directly to the final recipient. Instead, it routes and manages delivery through your configured adapters.

What Can ThorMail Send?

While email is the primary focus, ThorMail’s architecture supports any type of information to anywhere:

Email

Transactional, marketing, and notification emails via any adapter

SMS

Text messages via SMS gateways like Twilio or Vonage

Webhooks

Real-time data to third-party APIs and services

Push Notifications

Mobile and web push notifications via Firebase, OneSignal, etc.

The secret is ThorMail’s modular adapter system. Each adapter defines what it sends and where.

🔓 Zero Vendor Lock-in

Most messaging services trap you in their ecosystem. If they raise prices, ban your account, or suffer an outage, you are forced to rewrite your application code to switch providers.

ThorMail shatters this model.

• Switch Instantly: Move from AWS SES to SendGrid, or to your own SMTP server, by simply changing a configuration setting—zero code changes required.
• Own Your Logic: Your routing rules, templates, and logs live in your infrastructure, not in a provider’s black box.
• Leverage Pricing: When you can switch providers in seconds, you have the power to route traffic to the most cost-effective provider for every message.

Key Features

🚀 Extreme Speed

• Ultra-Fast Asynchronous API: Responses in milliseconds; processing happens in the background
• Batch Processing: Send 500 emails in a single HTTP request
• Concurrent Workers: Scale vertically or horizontally with multiple workers processing thousands of messages per second

⚡ Automatic Failover

Configure multiple adapters with different priorities (0-100):

1. High Priority (100): Your premium adapter (dedicated IP service)
2. Medium Priority (80): Your economical adapter (cloud-based email)
3. Low Priority (50): Backup SMTP server

If an adapter fails or hits rate limits, ThorMail instantly switches to the next one.

🔌 Unlimited Flexibility

• Use official and community adapters (SMTP, SendGrid, Webhooks, etc.)
• Install community adapters from NPM
• Create your own custom adapters

🔒 Security & Privacy

• GDPR Compliant: Full control over data storage and retention
• No Tracking by Default: Privacy-first approach
• Credential Encryption: API keys stored encrypted on YOUR infrastructure
• Self-Hosted: Your data never leaves your servers

Who is ThorMail For?

Use Case	Benefits
Personal Projects	Free tier, scales without code changes
Startups	Multi-provider reliability, cost optimization
Enterprise	Millions of daily messages, geo-distribution, compliance

Next Steps

Ready to get started? Continue to the Installation Guide.