docs: Add account management overview page

Updates remaining links to account sections on this page instead (_for `accounts`, `aliases`, `quotas`_).

This page will cover the features and defer to separate pages for more specific content where relevant.

README.md

@@ -38,8 +38,8 @@ A production-ready fullstack but simple containerized mail server (SMTP, IMAP, L
 
 ## :package: Included Services
 
-- [Postfix](http://www.postfix.org) with SMTP or LDAP authentication and support for [extension delimiters](https://docker-mailserver.github.io/docker-mailserver/v13.3/config/user-management/#address-tags-extension-delimiters-as-an-alternative-to-aliases)
-- [Dovecot](https://www.dovecot.org) with SASL, IMAP, POP3, LDAP, [basic Sieve support](https://docker-mailserver.github.io/docker-mailserver/latest/config/advanced/mail-sieve) and [quotas](https://docker-mailserver.github.io/docker-mailserver/v13.3/config/user-management/#quotas)
+- [Postfix](http://www.postfix.org) with SMTP or LDAP authentication and support for [extension delimiters](https://docker-mailserver.github.io/docker-mailserver/latest/config/account-management/overview/#aliases)
+- [Dovecot](https://www.dovecot.org) with SASL, IMAP, POP3, LDAP, [basic Sieve support](https://docker-mailserver.github.io/docker-mailserver/latest/config/advanced/mail-sieve) and [quotas](https://docker-mailserver.github.io/docker-mailserver/latest/config/account-management/overview/#quotas)
 - [Rspamd](https://rspamd.com/)
 - [Amavis](https://www.amavis.org/)
 - [SpamAssassin](http://spamassassin.apache.org/) supporting custom rules

docs/content/config/account-management/overview.md

@@ -0,0 +1,44 @@
+# Account Management - Overview
+
+## Mail Accounts - Domains, Addresses, Aliases
+
+`ACCOUNT_PROVISIONER` and supplementary pages referenced here.
+
+Anchor heading links stubbed out below.
+
+### Accounts
+
+### Aliases
+
+### Quotas
+
+## Technical Overview
+
+- Postfix handles when mail is delivered (inbound) to DMS, or sent (outbound) from DMS.
+- Dovecot manages mailbox storage for mail delivered to your DMS user accounts.
+
+??? abstract "Technical Details - Postfix"
+
+    Postfix needs to know how to handle inbound and outbound mail by asking these queries:
+
+    === "Inbound"
+
+        - What mail domains is DMS responsible for handling? (_for accepting mail delivered_)
+        - What are valid mail addresses for those mail domains? (_reject delivery for users that don't exist_)
+        - Are there any aliases to redirect mail to 1 or more users, or forward to externally?
+
+    === "Outbound"
+
+        - When `SPOOF_PROTECTION=1`, how should DMS restrict the sender address? (_eg: Users may only send mail from their associated mailbox address_)
+
+??? abstract "Technical Details - Dovecot"
+
+    Dovecot additionally handles authenticating user accounts for sending and retrieving mail:
+
+    - Over the ports for IMAP and POP3 connections (_110, 143, 993, 995_).
+    - As the default configured SASL provider, which Postfix delegates user authentication through (_for the submission(s) ports 465 & 587_). Saslauthd can be configured as an alternative SASL provider.
+
+    Dovecot splits all authentication lookups into two categories:
+
+    - A [PassDB][dovecot::docs::passdb] lookup most importantly authenticates the user. It may also provide any other necessary pre-login information.
+    - A [UserDB][dovecot::docs::userdb] lookup retrieves post-login information specific to a user.

docs/content/config/best-practices/dkim_dmarc_spf.md

@@ -359,7 +359,7 @@ volumes:
   - ./docker-data/dms/config/postfix-policyd-spf.conf:/etc/postfix-policyd-spf-python/policyd-spf.conf
 ```
 
-[docs-accounts-add]: ../user-management.md#adding-a-new-account
+[docs-accounts]: ../account-management/overview.md#accounts
 [docs-volumes-config]: ../advanced/optional-config.md#volumes-config
 [docs-env-opendkim]: ../environment.md#enable_opendkim
 [docs-env-rspamd]: ../environment.md#enable_rspamd

docs/content/config/environment.md

@@ -1140,7 +1140,7 @@ Provide the credentials to use with `RELAY_HOST` or `DEFAULT_RELAY_HOST`.
 [docs-tls-letsencrypt]: ./security/ssl.md#lets-encrypt-recommended
 [docs-tls-manual]: ./security/ssl.md#bring-your-own-certificates
 [docs-tls-selfsigned]: ./security/ssl.md#self-signed-certificates
-[docs-accounts-quota]: ./user-management.md#quotas
+[docs-accounts-quota]: ./account-management/overview.md#quotas
 [docs::relay-host]: ./advanced/mail-forwarding/relay-hosts.md
 [docs::dms-volumes-state]: ./advanced/optional-config.md#volumes-state
 [postfix-config::relayhost]: https://www.postfix.org/postconf.5.html#relayhost

docs/content/config/security/understanding-the-ports.md

@@ -145,7 +145,7 @@ Unlike with HTTP where a web browser client communicates directly with the serve
 
 Other machines that facilitate a connection that generally aren't taken into account can exist between a client and server, such as those where your connection passes through your ISP provider are capable of compromising a `cleartext` connection through interception.
 
-[docs-accounts]: ../user-management.md#accounts
+[docs-accounts]: ../account-management/overview.md#accounts
 [docs-relays]: ../advanced/mail-forwarding/relay-hosts.md
 [iana-services-465]: https://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml?search=465
 [starttls-policy-list]: https://github.com/EFForg/starttls-everywhere#email-security-database-starttls-policy-list

docs/content/usage.md

@@ -164,7 +164,7 @@ You definitely want to setup TLS. Please refer to [our documentation about TLS][
 
 You should add at least one [alias][docs-aliases], the [_postmaster alias_][docs-env-postmaster]. This is a common convention, but not strictly required.
 
-[docs-aliases]: ./config/user-management.md#aliases
+[docs-aliases]: ./config/account-management/overview.md#aliases
 [docs-env-postmaster]: ./config/environment.md#postmaster_address
 
 ```bash

docs/mkdocs.yml

@@ -132,6 +132,7 @@ nav:
   - 'Configuration':
     - 'Environment Variables': config/environment.md
     - 'Account Management':
+      - 'Overview': config/account-management/overview.md
       - 'Provisioner':
         - 'File Based': config/account-management/provisioner/file.md
         - 'LDAP Service': config/account-management/provisioner/ldap.md

mailserver.env

@@ -267,7 +267,7 @@ POSTFIX_DAGENT=
 # empty => 0
 POSTFIX_MAILBOX_SIZE_LIMIT=
 
-# See https://docker-mailserver.github.io/docker-mailserver/edge/config/user-management/accounts/#notes
+# See https://docker-mailserver.github.io/docker-mailserver/latest/config/account-management/overview/#quotas
 # 0 => Dovecot quota is disabled
 # 1 => Dovecot quota is enabled
 ENABLE_QUOTAS=1