Mailing Lists¶

The Mailman Suite (Mailman Core, Postorius, Hyperkitty) is installed on lists.opendev.org to run mailing lists for the OpenDev Collaboratory and projects it hosts, as well as archives of those lists.

At a Glance¶

Hosts:

https://lists.opendev.org (and numerous other aliases)

Ansible:

Projects:

Bugs:

Resources:

Mailman Documentation

Adding a List¶

A list may be added by adding it to the openstack-infra/system-config repository in system-config: inventory/service/group_vars/mailman3.yaml. For example:

- name: Example list
  description: 'This is an example'
  admin: 'admin@example.com'
  password: "{{ mailman_list_password }}"

Scripted Interaction with Lists¶

This may only be performed with root access to the list server.

sudo docker-compose -f /etc/mailman-compose/docker-compose.yaml exec -T -u mailman mailman-core mailman help

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.