<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>MemberManual/Email/MailingLists</title><revhistory><revision><revnumber>27</revnumber><date>2019-01-10 03:27:17</date><authorinitials>ClintonEbadi</authorinitials><revremark>document MailmanForceSSL</revremark></revision><revision><revnumber>26</revnumber><date>2019-01-10 01:50:44</date><authorinitials>ClintonEbadi</authorinitials><revremark>mention ssl support, update instructions for requesting a list name change.</revremark></revision><revision><revnumber>25</revnumber><date>2018-04-01 16:17:19</date><authorinitials>mta-71-69-176-248.nc.rr.com</authorinitials><revremark>Add not that mailmanWebHost is required even when using lists.hcoop.net as the web interface.</revremark></revision><revision><revnumber>24</revnumber><date>2013-01-14 09:15:40</date><authorinitials>ClintonEbadi</authorinitials><revremark>cat</revremark></revision><revision><revnumber>23</revnumber><date>2008-07-07 04:28:03</date><authorinitials>localhost</authorinitials><revremark>converted to 1.6 markup</revremark></revision><revision><revnumber>22</revnumber><date>2008-06-15 14:31:56</date><authorinitials>freat</authorinitials></revision><revision><revnumber>21</revnumber><date>2008-06-15 13:26:12</date><authorinitials>freat</authorinitials></revision><revision><revnumber>20</revnumber><date>2008-04-30 15:11:44</date><authorinitials>AdamChlipala</authorinitials><revremark>deleuze -&gt; mail</revremark></revision><revision><revnumber>19</revnumber><date>2007-12-15 17:30:43</date><authorinitials>AdamChlipala</authorinitials><revremark>members2 -&gt; members</revremark></revision><revision><revnumber>18</revnumber><date>2007-12-08 23:35:20</date><authorinitials>MichaelOlson</authorinitials><revremark>Separate simple setup from complicated setup with segue</revremark></revision><revision><revnumber>17</revnumber><date>2007-12-08 23:33:21</date><authorinitials>MichaelOlson</authorinitials><revremark>Reorg, emphasize that the portal request must be done after domtool setup</revremark></revision><revision><revnumber>16</revnumber><date>2007-12-08 06:40:34</date><authorinitials>MichaelOlson</authorinitials><revremark>Document some additional cases</revremark></revision><revision><revnumber>15</revnumber><date>2007-12-07 01:21:54</date><authorinitials>JustinLeitgeb</authorinitials><revremark>fix typo in address for lists run on main HCoop site.</revremark></revision><revision><revnumber>14</revnumber><date>2007-12-04 15:41:56</date><authorinitials>MichaelOlson</authorinitials></revision><revision><revnumber>13</revnumber><date>2007-12-04 15:40:31</date><authorinitials>MichaelOlson</authorinitials><revremark>Change variable notation</revremark></revision><revision><revnumber>12</revnumber><date>2007-12-04 15:38:04</date><authorinitials>MichaelOlson</authorinitials><revremark>List admin needs to change the host_name setting</revremark></revision><revision><revnumber>11</revnumber><date>2007-11-19 18:02:29</date><authorinitials>MichaelOlson</authorinitials><revremark>update instructions and remove warning</revremark></revision><revision><revnumber>10</revnumber><date>2007-11-16 23:29:28</date><authorinitials>MichaelOlson</authorinitials><revremark>fix listinfo link</revremark></revision><revision><revnumber>9</revnumber><date>2007-11-16 23:28:54</date><authorinitials>MichaelOlson</authorinitials><revremark>remove quotes from link desc</revremark></revision><revision><revnumber>8</revnumber><date>2007-11-16 23:28:05</date><authorinitials>MichaelOlson</authorinitials><revremark>Revamp, add migration instructions</revremark></revision><revision><revnumber>7</revnumber><date>2007-11-14 19:23:59</date><authorinitials>MichaelOlson</authorinitials><revremark>Update partially</revremark></revision><revision><revnumber>6</revnumber><date>2007-11-12 06:26:40</date><authorinitials>MichaelOlson</authorinitials><revremark>Try to categorize a bit</revremark></revision><revision><revnumber>5</revnumber><date>2007-11-01 22:47:19</date><authorinitials>MichaelOlson</authorinitials><revremark>Mark as out of date</revremark></revision><revision><revnumber>4</revnumber><date>2007-11-01 22:41:15</date><authorinitials>MichaelOlson</authorinitials><revremark>make part of member manual</revremark></revision><revision><revnumber>3</revnumber><date>2006-09-30 19:01:19</date><authorinitials>AdamChlipala</authorinitials></revision><revision><revnumber>2</revnumber><date>2006-09-30 17:06:07</date><authorinitials>ClintonEbadi</authorinitials><revremark>improve content</revremark></revision><revision><revnumber>1</revnumber><date>2005-08-08 06:09:11</date><authorinitials>AdamChlipala</authorinitials></revision></revhistory></articleinfo><para>This page describes how to set up and manage mailing lists on your domain. </para><section><title>Request a Mailing List</title><para>If you would like a mailing list managed by our global <ulink url="http://www.gnu.org/software/mailman/">Mailman</ulink> <ulink url="https://lists.hcoop.net/listinfo">installation</ulink>, you must <emphasis role="strong">first follow the setup instructions</emphasis> below to tweak your <ulink url="https://wiki.hcoop.net/MemberManual/Email/MailingLists/DomTool#">DomTool</ulink> configuration, and then <ulink url="https://members.hcoop.net/portal/list">place a request on the portal</ulink>.  If you do things in this order, the portal will be able to correctly deduce what URL you want for the web interface of the new mailing list. </para></section><section><title>Setup Instructions</title><para>You then have a choice between doing list management at <ulink url="https://lists.hcoop.net/admin/LISTNAME"/> or at your own domain. </para><section><title>Using https://lists.hcoop.net/ for the web interface</title><para>If you are fine with using the main hcoop.net site for your list's web interface, then there is nothing left to do before making a list request on the portal and wait for the list to be created. </para><para>You can then access your list at <code>https://lists.hcoop.net/admin/LISTNAME</code>, where <emphasis role="strong">LISTNAME</emphasis> is the name of your list. </para><para>If you requested a list where the address will be at your own domain, even if you are using lists.hcoop.net for the management URL, you will need to add the following line </para><itemizedlist><listitem override="none"><para>mailmanWebHost &quot;lists.hcoop.net&quot;; </para></listitem></itemizedlist><para>to your domtool configuration for that domain. In addition to configuring the Mailman web interface, it also configures the mail server to forward incoming mail to Mailman for processing. </para></section><section><title>Using your own domain for the web interface</title><para>If you would like the web interface to be at your own domain, then you must do some simple domain configuration. </para><itemizedlist><listitem><para><emphasis role="strong">$LISTNAME</emphasis> is the name you gave your list, </para></listitem><listitem><para><emphasis role="strong">$DOMAIN</emphasis> is your domain, </para></listitem><listitem><para><emphasis role="strong">$VHOST</emphasis> is the virtual subdomain you would like the web interface to be accesible from. </para></listitem><listitem><para><emphasis role="strong">$USER</emphasis> is your HCoop username. </para></listitem></itemizedlist><para>If you want to access the site from your domain with no subdomain, then use the default virtual host for <emphasis>$VHOST</emphasis> (in other words, &quot;www&quot;). </para><screen><![CDATA[domain "$DOMAIN" with
  (* Other configuration stuff...  *)
]]><![CDATA[
  mailman "$VHOST";
  (* Make list interface available over SSL as well. If you want to redirect http to https, use:
]]><![CDATA[
     mailman "$VHOST" where
       MailmanForceSSL = true;
     end;
]]><![CDATA[
     for the non-ssl vhost.
  *)
  mailman "$VHOST" where
    SSL = $your_ssl_cert;
  end;
]]><![CDATA[
  (* Do the following if you want the email address given on *)
  (* http://$VHOST.$DOMAIN/listinfo to work. *)
  handleMail;
  emailAlias "mailman" "$USER";
end;]]></screen><para>Now request the list using the portal.  The list admin web interface then will be available at <code>http://$VHOST.$DOMAIN/admin/$LISTNAME</code>. </para><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="https://wiki.hcoop.net/moin_static1911/moniker_bt/img/alert.png" width="16"/></imageobject><textobject><phrase>/!\</phrase></textobject></inlinemediaobject> Be sure to change the <emphasis role="strong">host_name</emphasis> setting for the list to be &quot;$DOMAIN&quot; (namely, your domain name) using the list admin web interface, or messages sent to that list will come from the wrong domain! </para><para>If you want to do anything more complicated than the above, read on. </para></section><section><title>Putting the list email address and web interface on different domains</title><para>Say you want to receive email to a list at <code>mylist@emailsub.domain.tld</code>, but you want the web interface for the list to be at <code>http://lists.domaintwo.tld</code>.  Here is how you accomplish that. </para><itemizedlist><listitem><para>Make sure that you have been granted the <code>domaintwo.tld</code> domain. </para></listitem><listitem><para>Add the following domtool configuration </para><screen><![CDATA[domain "domaintwo.tld" with
  mailmanVhost "lists";
end;
]]><![CDATA[
domain "domain.tld" with
  mailmanWebHost "lists.domaintwo.tld";
end;]]></screen></listitem><listitem><para>Tell the list admin to update your list url to <code>http://lists.domaintwo.tld</code>, by filing a request in the portal with the &quot;list&quot; category. </para></listitem></itemizedlist></section><section><title>Permitting email for the same list to be delivered to multiple domains</title><para>Say you have a list called &quot;listname&quot;.  If you want to permit email from both &quot;<ulink url="mailto:listname@domain.tld">listname@domain.tld</ulink>&quot; and &quot;<ulink url="mailto:listname@domaintwo.tld">listname@domaintwo.tld</ulink>&quot;, then you will need to do the following. </para><itemizedlist><listitem><para>Choose a &quot;canonical&quot; domain, between the two.  Mailman will only get the links correct on the web interface with this domain name.  We will denote the other domain as the secondary domain. </para></listitem><listitem><para>Add a &quot;mailmanVhost&quot; line to the domtool configuration for each domain, or make one domain an alias of the other.  The canonical domain should not be an alias.  In the case that you are adding a &quot;mailmanVhost&quot; line, be sure that the canonical domain comes before the secondary domain. </para></listitem><listitem><para>Using the web interface, edit acceptable_aliases to include a regexp like </para><screen><![CDATA[^listname@domaintwo\.tld$]]></screen></listitem><listitem><para>File a request on the &quot;list&quot; category of the portal, mentioning that you want to do this, and mention which domain is the canonical one.  <ulink url="https://wiki.hcoop.net/MemberManual/Email/MailingLists/MichaelOlson#">MichaelOlson</ulink> will take care of the rest. </para></listitem></itemizedlist></section></section><section><title>Hosting Domains Elsewhere</title><para>You can host mailing lists with us that use your own domains, even if your domain is primarily hosted elsewhere. </para><para>The best way of doing this is for you to point your domain's MX record to <code>mail.hcoop.net</code>.  If you want to use the Mailman webinterface on a subdomain, then be sure to point that subdomain at <code>mail.hcoop.net</code>. </para></section><section><title>Migrating an Existing List</title><para>If you previously hosted a mailing list on Fyodor, our old machine, then file a request at <ulink url="https://bugzilla.hcoop.net/enter_bug.cgi">Our bug-tracker</ulink>, using the <emphasis role="strong">Mailman</emphasis> component.  Be sure to tell us what the name of your list is. </para><para>If you haven't hosted a mailing list with us before, it is still possible to migrate a list over to our machines, provided that you have an mbox file containing the archives, and the file <code>config.pck</code> containing your settings.  File a request at <ulink url="https://bugzilla.hcoop.net/enter_bug.cgi">Our bug-tracker</ulink>, using the <emphasis role="strong">Mailman</emphasis> component, and we will help you out. </para><!--rule (<hr>) is not applicable to DocBook--><para> <ulink url="https://wiki.hcoop.net/MemberManual/Email/MailingLists/CategoryMemberManual#">CategoryMemberManual</ulink> </para></section></article>