mailman3_ynh/README.md

Mailman3 for YunoHost

Read this README is other languages.

This package allows you to install Mailman3 quickly and simply on a YunoHost server.
If you don't have YunoHost, please consult the guide to learn how to install it.

Overview

Electronic mailing lists manager

Shipped version: 1.0~ynh2

Demo: https://lists.mailman3.org/mailman3/lists/

Screenshots

Disclaimers / important information

• Any known limitations, constrains or stuff not working, such as (but not limited to):

  • requiring a full dedicated domain

• Other infos that people should be aware of, such as:

  • No LDAP support yet (apparently under development)
  • Users can also just sign up themselves to manage details
  • Users can use mailing lists without signing up?

Classical admin is available on the page: https://myyunohost.org/

Django admin on: https://myyunohost.org/admin/

General Configuration

Mailman 3 or "The Mailman Suite" is made up of 5 moving parts. See the following documentation for more:

http://docs.mailman3.org/en/latest/index.html#the-mailman-suite

On your YunoHost, all the configuration files you need to worry about are in:

• /etc/mailman3/
• /usr/share/mailman3-web/

The services you need to manage can be checked with:

• systemctl status mailman3
• systemctl status mailman3-web

It is important to note that this package makes use of the mailman3-full Debian package contained in the Debian Stretch backports repository. The default installation assumes the use of a SQLite3 database but the installation script overrides this and uses a PostgreSQL database instead.

Finally, you also configure things through the Django web admin available at /admin/.

Limitations

• Migrating from Mailman 2.X is not officially supported, sorry. However, there is a manual and which details an experimental process. Please see the documentation.

• Mailman3 must be configured to use a root domain (https://myyunohost.org and not https://myyunohost.org/mailman3).

• You must have a HTTPS certificate installed on the root domain.

• There may be only one installation per YunoHost.

Documentation and resources

• Official app website: http://www.list.org/
• Official user documentation: http://docs.mailman3.org/en/latest/userguide.html
• Official admin documentation: https://docs.mailman3.org/en/latest/
• Upstream app code repository: https://gitlab.com/mailman/mailman-suite
• YunoHost Store: https://apps.yunohost.org/app/mailman3
• Report a bug: https://github.com/YunoHost-Apps/mailman3_ynh/issues

Developer info

Please send your pull request to the testing branch.

To try the testing branch, please proceed like that:

sudo yunohost app install https://github.com/YunoHost-Apps/mailman3_ynh/tree/testing --debug
or
sudo yunohost app upgrade mailman3 -u https://github.com/YunoHost-Apps/mailman3_ynh/tree/testing --debug

More info regarding app packaging: https://yunohost.org/packaging_apps