David Newman writes:
I am looking for a high-level "do these steps next to get a list working" document rather than an API command reference.
There's no such documentation. "Get a list working" depends on what you mean by "working". The basic answer is
- Install Mailman 3 suite.
- Log in to Postorius as an admin user and create the list.
After that, it's case-specific.
- why do the venv docs and admin FAQ give different nginx configs for the reverse proxy?
Because the FAQ is providing a short snippet to solve a specific problem, the venv docs provide what I guess is somebody's full working config. Setting up a Mailman server is complex; usually any example you see in the docs is somebody's "works for me" configuration.
- Does the 'Secret_Hyperkitty_API_Key' need to go anywhere else besides /opt/mailman/mm/mailman-hyperkitty.cfg?
It needs to match MAILMAN_ARCHIVER_KEY in HyperKitty's settings.py. There are a couple of reasonable ways to organize HyperKitty and Postorius configs, I'm not sure where the appropriate settings.py would be on your server.
- For Django (presumably in /etc/mailman3/settings.py, but the docs don't say), what values to use with Postfix to set up the email back end?
The answer is "that depends on your mail environment". As far as I know, normally it just works with the default settings, but if your Postfix requires secure, you need to set that up: https://docs.djangoproject.com/en/3.2/ref/settings/#std:setting-EMAIL_USE_TL... and possibly the following 3 or 4 variables if authentication is needed.
There was a thread on this a couple of weeks ago.