source: server/mail/qmail/qmail-config.xml@ 4958384

<sect2>
<title>Configuring <application>qmail</application></title>

<sect3><title>Config files</title>
<para><filename>/etc/inetd.conf</filename> and boot scripts</para>
</sect3>

<sect3><title>Configuration Information</title>

<para>If <command>inetd</command> is used, the following command will add the qmaild
entry to <filename>/etc/inetd.conf</filename>: </para>

<para><screen><userinput>echo "smtp stream tcp nowait qmaild /var/qmail/bin/tcp-env \
tcp-env /var/qmail/bin/qmail-smtpd" &gt;&gt; /etc/inetd.conf</userinput></screen></para>

<para>If <command>xinetd</command> is used, the following command will add the qmaild
entry to <filename>/etc/xinetd.conf</filename>: </para>

<screen><userinput><command>cat &gt;&gt; /etc/xinetd.conf &lt;&lt; "EOF"</command>
service smtp
{
    disable = no
    identifier              = smtp-local
    socket_type             = stream
    protocol                = tcp
    wait                    = no
    user                    = qmaild
    server                  = /var/qmail/bin/tcp-env
    server_args             = /var/qmail/bin/qmail-smtpd
    env                     = RELAYCLIENT=
    only_from               = 127.0.0.1
    log_on_failture         += USERID
}
<command>EOF</command></userinput></screen>

<para>To automate the running of <application>qmail</application>, use following command to
create the init.d script:</para> 

<screen><userinput><command>cat &gt; /etc/rc.d/init.d/qmail &lt;&lt; "EOF"</command>
#!/bin/sh
# Begin $rc_base/init.d/qmail

# Based on sysklogd script from LFS-3.1 and earlier.
# Rewritten by Gerard Beekmans  - gerard@linuxfromscratch.org

source /etc/sysconfig/rc
source $rc_functions

case "$1" in

        start)
        echo "Starting Qmail..."
        /var/qmail/rc &amp;
        ;;

        stop)
        echo "Stopping Qmail..."
        killall qmail-send
        ;;
                
        restart)
        $0 stop
        sleep 1
        $0 start
        ;;

        *)
        echo "Usage: $0 {start|stop|restart}"
        exit 1
        ;;
esac

# End $rc_base/init.d/qmail
<command>EOF
chmod 755 /etc/rc.d/init.d/qmail</command></userinput></screen>

<para>Create the symbolic links to this file in the relevant
<filename>rc.d</filename> directory with the following commands:</para>

<screen><userinput><command>cd /etc/rc.d/init.d &amp;&amp;
ln -sf ../init.d/qmail ../rc0.d/K25qmail &amp;&amp;
ln -sf ../init.d/qmail ../rc1.d/K25qmail &amp;&amp;
ln -sf ../init.d/qmail ../rc2.d/K25qmail &amp;&amp;
ln -sf ../init.d/qmail ../rc3.d/S35qmail &amp;&amp;
ln -sf ../init.d/qmail ../rc4.d/S35qmail &amp;&amp;
ln -sf ../init.d/qmail ../rc5.d/S35qmail &amp;&amp;
ln -sf ../init.d/qmail ../rc6.d/K25qmail</command></userinput></screen>

</sect3>

<sect3><title>Configuring mailers to work with qmail</title>
<para>Configuration information for some commonly used MUAs can be
found in the <filename>/var/qmail/doc/INSTALL.mbox</filename>
file.  Most MUAs can be configured to use qmail Mailbox format buy
putting the following in <filename>~/.profile</filename>:</para>
<para><screen><userinput>MAIL=$HOME/Mailbox; export MAIL
</userinput></screen></para></sect3>

</sect2>