Open-source email infrastructure: SMTP inbound/submission, IMAP, orchestration, async workers, auth, push notifications, and portable domain export/import.

Project home: midi-email/midemail

• Quickstart
• Architecture
• Configuration
• API Reference
• Deployment
• Operations

• SMTP inbound gateway (cmd/smtp-inbound)
• SMTP submission gateway (cmd/smtp-submission)
• IMAP server (cmd/imap)
• Unified mail worker (cmd/mail-worker)
• Orchestrator (cmd/orchestrator)
• API service (cmd/api)
• Autoconfig/autodiscover service (cmd/autoconfig)
• Migration CLI (cmd/migrate)

• Mail backend with programmable APIs
• API key first provisioning and operations endpoints
• Forward-only SQL migrations
• Queue-based processing with retries and DLQ
• Domain-level export/import as ZIP with .eml + metadata
• Multi-cloud object storage providers:
  • local filesystem
  • S3 / S3-compatible
  • Google Cloud Storage
  • Azure Blob
• Push notifications:
  • FCM
  • APNs

• VM binaries
• All-in-one Docker image (MIDEMAIL_SERVICE=...)
• Kubernetes manifests (deploy/k8s)
• Terraform baseline for Linode (deploy/terraform/linode)
• Serverless/container platforms (Cloud Run, Lambda container adapters)

• cmd/ entrypoints
• internal/ core services and packages
• database/migrations/ schema
• deploy/k8s/ Kubernetes manifests
• deploy/terraform/linode/ Linode IaC
• docker/ image runtime scripts
• docs/ documentation

GPL-3.0 (see LICENSE).

1. Create org with user auth.
2. Create scoped org API key (POST /orgs/api-keys).
3. Use X-API-Key (or Authorization: ApiKey ...) on /v1/* endpoints.

Provisioning endpoints:

• POST /v1/domains
• POST /v1/mailboxes
• POST /v1/webhooks
• POST /v1/mail/send
• POST /v1/mail/receive

Suggested scopes:

• domains:write
• mailboxes:write
• webhooks:write
• mail.send
• mail.receive
• or wildcard admin:*