sympa-community.github.io

Incubating the new Sympa documentation site

Configure HTTP server

Requirements

Sympa configuration parameters

See “Web interface parameters” in sympa.conf(5) for more parameters for web interface.

And following parameter in sympa.conf may be useful:


Note:


Two ways to integrate

There are two ways to integrate Sympa into HTTP server:

The former is recommended. However, if you will never have plan to manage multiple domains, the latter is easier way.

You can not mix both ways. Following sections describe these two ways by each.

Virtual domain setting

  1. If path of MHonArc executable file is differ from the default of mhonarc parameter, /usr/bin/mhonarc, define it in sympa.conf. For example:

    mhonarc /usr/local/bin/mhonarc
    
  2. If directories for virtual domain configurations have not been created, create them (Note: replace $SYSCONFDIR, $EXPLDIR and mail.example.org below):
    # mkdir -m 755 $SYSCONFDIR/mail.example.org
    # touch $SYSCONFDIR/mail.example.org/robot.conf
    # chown -r sympa:sympa $SYSCONFDIR/mail.example.org
    # mkdir -m 750 $EXPLDIR/mail.example.org
    # chown sympa:sympa $EXPLDIR/mail.example.org
    
  3. Edit robot.conf created by the step above to add parameter(s) described in previous section:
    wwsympa_url http://web.example.org/sympa
    

    Note:

    • On Sympa 6.2.18 or earlier, robot.conf had to contain additional http_host parameter, like:
      wwsympa_url http://web.example.org/sympa
      http_host web.example.org/sympa
      

      There is no reason to use http_host on later releases.


  4. Setup HTTP server according to description in “Instruction by HTTP servers”.

If you want to add another domain, repeat steps in this section by each domain.

Single domain setting

  1. Edit sympa.conf to add parameter(s) described in previous section:
    domain (...existing parameter value...)
    listmaster (...existing parameter value...)
    wwsympa_url http://web.example.org/sympa
    mhonarc /usr/local/bin/mhonarc     (If path is differ from the default)
    
  2. Setup HTTP server according to description in “Instruction by HTTP servers” section.

Instruction by HTTP servers

These methods are reported to be applicable to Apache HTTP Server (2.4 or later), nginx and lighttpd.

Obsoleted methods

These pages describe the method using setuid wrappers (wwsympa-wrapper.fcgi and sympa_soap_server-wrapper.fcgi) which are no longer recommended.

Tests

  1. Start web browser on your PC or PDA.

  2. Open the URL http://web.example.org/sympa (the URL you have configured). And confirm that home page of Sympa web interface will be shown.

If something went unexpected, check following information:

CC BY-SA 4.0 Unless otherwise specified, the contents of this document are licensed under the Creative Commons - Attribution - ShareAlike license. For more details see LICENSE and AUTHORS.

Theme originally designed by orderedlist