The Apache HTTP Server Project

Essentials

  • About
  • License
  • FAQ
  • Security
    Reports
  • Download!

  • from a mirror
  • Documentation

  • Version 2.2
  • Version 2.0
  • Version 1.3
  • Trunk (dev)
  • Wiki
  • Get Involved

  • Mailing Lists
  • Bug Reports
  • Developer Info
  • Subprojects

  • Docs
  • Test
  • Flood
  • libapreq
  • Modules
  • mod_fcgid
  • mod_ftp
  • Miscellaneous

  • Awards
  • Contributors
  • Sponsors
  • Sponsorship
  • Support
    Webring
  • Installation instructions

    mod_smtpd is very easy to install and setup. First, we need to build the module and make the Apache HTTPd webserver load it. Then, we'll setup our archives repository and complete Apache's configuration.

    mod_smtpd has, of course, some requirements :

    • Apache HTTPd >= 2.2 (mod_smtpd has been tested succesfully with Apache 2.2.0 and 2.3.0-dev)
    • APR and APR-Util >= 0.9
    • libapreq2
    Download and build

    Checkout sources via Subversion :

    svn checkout https://svn.apache.org/repos/asf/httpd/mod_smtpd/trunk mod_smtpd

    Then, build mod_smtpd :

    ./autogen.sh
    ./configure
    make clean all
    su -c 'make install'

    Refer to the configure help (./configure --help) if you need a to specify an installation prefix (--prefix=...) or any other specific setup.

    Preliminary Apache setup

    The next step is to make Apache HTTPd load the mod_smtpd module at runtime. Edit your Apache configuration file, and add the following to the rest of the LoadModule lines :

    LoadModule smtpd_module /usr/lib/apache2/modules/mod_smtpd.so

    Or replace that directory with your default Apache 2.2 install directory.

    mod_smtpd configuration

    You now need to configure Apache to run mod_smtpd whenever a network connection comes in. We recommend this virtual host setup:

    NameVirtualHost *:80
    NameVirtualHost *:25

    <VirtualHost *:80>
    # your webserver configuration here
    </VirtualHost >

    <VirtualHost *:25>
    ServerName localhost # or whatever desired
    SmtpProtocol On
    # addition mod_smtpd or associated plugin configuration here
    </VirtualHost >

    Copyright © 2009 The Apache Software Foundation