Skip to Content.
Sympa Menu

Configure HTTP server: Apache HTTP Server (compatible with earlier version)


Note:


Requirements


Note:


General instruction

  1. If you have not added configuration for Sympa to httpd, add following excerpt (Note: replace $EXECCGIDIR and $STATICDIR):

    For HTTP Server 2.4:

    <Location /sympa>
        SetHandler fcgid-script
    
        # Don't forget to edit lines below!
        Require all denied
        #Require all granted
    </Location>
    ScriptAlias /sympa $EXECCGIDIR/wwsympa-wrapper.fcgi
    
    ## You may uncomment following lines to enable SympaSOAP feature.
    #<Location /sympasoap>
    #    SetHandler fcgid-script
    #
    #    # Don't forget to edit lines below!
    #    Require all denied
    #    #Require all granted
    #</Location>
    #ScriptAlias /sympasoap $EXECCGIDIR/sympa_soap_server-wrapper.fcgi
    
    # Other static contents
    Alias /static-sympa $STATICDIR
    
    ## If your host is dedicated to Sympa:
    #RewriteEngine on
    #RewriteRule ^/?$ /sympa [R=301]
    

    For HTTP Server 2.2:

    <Location /sympa>
        SetHandler fcgid-script
    
        # Don't forget to edit lines below!
        Order deny,allow
        Deny from all
        #Allow from all
    </Location>
    ScriptAlias /sympa $EXECCGIDIR/wwsympa-wrapper.fcgi
    
    ## You may uncomment following lines to enable SympaSOAP feature.
    #<Location /sympasoap>
    #    SetHandler fcgid-script
    #
    #    # Don't forget to edit lines below!
    #    Order deny,allow
    #    Deny from all
    #    #Allow from all
    #</Location>
    #ScriptAlias /sympasoap $EXECCGIDIR/sympa_soap_server-wrapper.fcgi
    
    # Other static contents
    Alias /static-sympa $STATICDIR
    
    ## If your host is dedicated to Sympa:
    #RewriteEngine on
    #RewriteRule ^/?$ /sympa [R=301]
    

    Additionally with Sympa 6.2.28 or later, it is possible to set separate paths for style sheets and pictures.

    • If either or both of parameters css_path and css_url were changed from the default, you also need to add the following settings (Note: replace $css_url and $css_path below):
      Alias $css_url $css_path
      
    • If either or both of parameters pictures_path and pictures_url were changed from the default, you also need to add the following settings (Note: replace $pictures_url and $pictures_path below):
      Alias $pictures_url $pictures_path
      

    Note:

    • Some binary distributions ship configuration ready to edit:

      • On Debian (10 “buster” or earlier), /etc/apache2/conf-available/sympa.conf file is prepared. Also, separate /etc/apache2/conf-available/sympa-soap.conf file is prepared for SympaSOAP feature.

      • On RPM (RHEL/CentOS 6), /etc/httpd/conf.d/sympa.conf file is prepared by sympa-httpd package.


  2. Edit it as you prefer.

    Note that ServerName or ServerAlias directive should define the host part of wwsympa_url parameter. Because Sympa refers to SERVER_NAME CGI environment variable to determine host name of web service.

    You may also tune FastCGI by adding directives such as FcgidIOTimeout, FcgidMaxProcesses or FcgidMaxRequestLen. For more details see the mod_fcgid reference page.

  3. Restart httpd.

Top of Page