Skip to content

Installation

Pick the deployment method that fits your environment. All methods run the same container/image and read the same environment variables.

Method Best for Complexity
Docker Quick setup, small deployments Low
Azure Azure-native, one-click deploy Low–Medium
Kubernetes Scalable production workloads Medium
Manual Full control, custom hosts Medium

Requirements

Required

  • Docker, Kubernetes, or Python 3.11+ (manual)
  • Outbound network access to login.microsoftonline.com and graph.microsoft.com
  • An Entra ID application (client secret + scoped send rights)
  • A TLS certificate for production

Optional

  • Azure Key Vault — TLS certificate storage (config)
  • Azure Table Storage — central credential lookup (guide)
  • Managed Identity — passwordless access to the Azure services above

After installing

  1. Set up Entra ID
  2. Configure the relay
  3. Configure your SMTP clients