Explanation

Understanding-oriented discussion of concepts, architecture, and design decisions.

Explanation guides clarify and illuminate particular topics. They broaden the understanding of cdk8s-mailu and help you make informed decisions about how to use it.

Architecture & Concepts

• Architecture Overview
• Authentication Flows
• Nginx Configuration Patches
• Storage Architecture
• Dovecot Submission Service
• Egress Gateway Considerations for Mail Delivery
• CDK8S Patterns

Key Topics

This section explains:

• Mailu architecture and component relationships

• Authentication mechanisms (nginx auth_http, SSO, network trust)

• Nginx configuration patching for Traefik TLS termination

• Storage architecture and sizing for mail data

• CDK8S construct patterns and best practices

• Dovecot submission service for webmail sending

• Egress gateway considerations for consistent sender IPs

Future topics:

• Security considerations

• Scaling and high availability considerations

Design Decisions

This section will document:

• Why certain defaults were chosen

• Trade-offs in configuration approaches

• Integration strategies with external services

• Testing philosophy

---

Ready to get started? Jump into the Tutorials for hands-on lessons.

Need to solve a problem? See the How-To Guides for task-oriented solutions.

Looking for specifications? Check the Reference section for API documentation.