Elemta - High-Performance SMTP Server

Elemta: A high-performance SMTP server written in Go with comprehensive email authentication (SPF, DKIM, DMARC, ARC), advanced queue management, and extensive monitoring capabilities. Features a pluggable architecture, containerized deployment, and security-first design.

Key Features

• High Performance: Built with Go for excellent concurrency and performance
• Pluggable Architecture: Easily extend functionality with plugins
• Security-First: Built-in SPF, DKIM, DMARC, and ARC validation
• Container Security: Non-root execution with hardened Docker and Kubernetes configurations
• Cloud-Native: Ready for Docker and Kubernetes deployment
• Comprehensive Monitoring: Prometheus/Grafana integration with pre-built dashboards
• Enhanced Delivery Tracking: IP address logging and detailed delivery analytics
• Flexible Time-Scale Reporting: Hourly, daily, weekly, and monthly delivery trend analysis
• API-Driven: RESTful API for management and monitoring

Quick Start

Docker Deployment (Recommended)

git clone https://github.com/busybox42/elemta.git
cd elemta
docker-compose up -d

Access Services:

• Web UI: http://localhost:8025 (admin:password)
• SMTP Server: localhost:2525
• Grafana Monitoring: http://localhost:3000 (admin:elemta123)

Kubernetes Deployment

kubectl apply -f k8s/
kubectl port-forward service/elemta-web 8025:8025

From Source (Development)

git clone https://github.com/busybox42/elemta.git
cd elemta
go build -o elemta cmd/elemta/main.go
./elemta -config config/elemta.yaml

Documentation

Core Documentation

• Installation & Deployment - Detailed setup instructions
• Configuration Reference - Complete configuration options
• API Reference - Complete REST API documentation
• Email Authentication - SPF, DKIM, DMARC, ARC setup
• Plugin Development - Creating custom plugins

Production & Operations

• Production Deployment - Enterprise deployment guide
• Troubleshooting - Common issues and solutions
• Monitoring & Metrics - Prometheus/Grafana setup
• Queue Management - Queue operations and troubleshooting
• CLI Tools - Command-line utilities

Standards & Development

• RFC Compliance - SMTP RFC standards implementation status
• Testing - Testing procedures and tools
• Docker Deployment - Advanced Docker configuration
• Logging - Log management and analysis

Advanced Topics

• Let's Encrypt Integration - Automatic TLS certificate management
• Security Hardening - Production security guide
• Performance Tuning - Optimization guide

Architecture

Elemta uses a modular architecture with these core components:

• SMTP Server: Protocol handling and message processing
• Plugin System: Extensible processing pipeline
• Queue Manager: Message queuing, retries, and delivery tracking
• Monitoring: Metrics collection and alerting
• API Server: RESTful management interface

For detailed architecture information, see Architecture Documentation.

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

See Development Workflow for detailed contribution guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Need Help? Check our documentation or open an issue on GitHub.