opendev/system-config
Code Issues Proposed changes

Merge "Add documentation about Django/Mailman super user"

Browse Source
This commit is contained in:
Zuul 2024-11-01 16:22:29 +00:00 committed by Gerrit Code Review
commit cb502bd292
1 changed files with 19 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
doc/source/lists.rst
View File

@ -52,3 +52,22 @@ This may only be performed with root access to the list server.
Use context help for the CLI's many subcommands, or see the Mailman v3
documentation for more details.
Django Admin Interface
======================
There is an admin WebUI at ``/admin/``, but it's only accessible over a
loopback from localhost. If you need to use it, you'll want to connect an
SSH tunnel from your own system and then override DNS resolution for
``lists.opendev.org`` to point to your loopback address.
List Configuration and Moderation Backdoor
==========================================
If you need to step in and assist a list moderator or owner with
configuration and moderation tasks, you can log into the appropriate
Postorius URL for the corresponding list domain with the Django admin
credentials. This is effectively a Mailman "super user" account (as well as
being the account for administering the underlying Django installation).
This same account can be similarly used in Hyperkitty to delete spam
messages and threads in an emergency if the list owner is unavailable.