#pragma section-numbers off

This page describes how to set up and manage mailing lists on your domain.

[[TableOfContents]]

/!\ '''This page is currently out of date.'''   We are still figuring out how to migrate mailing lists and set up Mailman.

= Request a mailing list =

If you would like a mailing list managed by our global [http://www.gnu.org/software/mailman/ Mailman] installation you must first [https://members2.hcoop.net/portal/list place a request on the portal].

= Setup instructions =

You then have a choice between doing list management at [https://lists.hcoop.net/admin/LISTNAME https://lists.hcoop.net/admin/''LISTNAME''] or at your own domain.

If you are fine with using the main hcoop.net site for your list's web interface, then there is nothing left to do except wait for the list to be created. If you would like the web interface to be at your own domain, then you must do some simple domain configuration.

 * '''LISTNAME''' is the name you gave your list,
 * '''DOMAIN''' is your domain,
 * '''TLD''' is the top-level domain (org, com, name, ...) of your domain,
 * '''VHOST''' is the virtual subdomain you would like the web interface to be accesible from.

If you want to access the site from your domain with no subdomain, then use the default virtual host for ''VHOST''.

 * Write `VHOST.DOMAIN.TLD` to `/etc/domains/TLD/DOMAIN/.mailman`.  You must do this '''before''' requesting the list on the portal or it will have no effect.
 * Place the `Mailman` directive in the VirtualHostConfiguration at `/etc/domains/TLD/DOMAIN/VHOST`.
 * Run domtool

= Manage your mailing lists =

The list admin web interface will be available at {{{https://VHOST.DOMAIN.TLD/admin/LISTNAME}}}.

= Hosting domains elsewhere =

Note that you '''can''' host mailing lists with us that use your own domains even if your domain is primarily hosted elsewhere. However, the best way we know of doing this is for you to point your domain's MX record to `deleuze.hcoop.net`. If you don't know what this means, then you probably shouldn't be trying anything so complicated as splitting a domain's hosting between several providers in the first place.