NAME

toaster_setup.pl - Everything you need to build a mail toaster except a computer


SYNOPSIS

To build a great mail system, install FreeBSD (latest stable), and follow the directions on the toaster page (see URL below).


DESCRIPTION

A complete set of instructions for building a mail toaster are on the toaster install page. There is actually quite a bit of documenation available for the ``Matt Style'' toaster. Much of it is readable via ``perldoc Mail::Toaster'', and all the subsequent pages. Don't forget to read the Install, Configure, and FAQ pages on the web site. If you still have questions, the mailing list archives are browseable and searchable for your convenience.

        http://www.tnpi.biz/internet/mail/toaster/

command line flags

toaster_setup.pl can be passed several flags. -s [ section ] - run without a parameter to see the available options -d [ debug ] - enabled (very) verbose debugging output -a [ action ] - default action is ``install''.

An -a upgrade option is planned.


USAGE

  toaster_setup.pl -s [ section ] [-debug]
           pre - installs a list of programs and libraries other toaster components need
         ports - updates your ports tree, installs the pkg_* tools
       sources - update your FreeBSD sources (/usr/src)
         mysql - installs MySQL
    phpmyadmin - installs phpMyAdmin
        apache - installs Apache 
     apachessl - installs self signed SSL certs for Apache
    apacheconf - patches httpd.conf for use with Mail::Toaster
         ucspi - install ucspi w/MySQL patch
         ezmlm - install EzMLM idx
      vpopmail - installs vpopmail
     vpeconfig - configure ~vpopmail/etc/tcp.smtp
     vpopmysql - run the vpopmail MySQL grant and db create commands
         qmail - installs qmail with toaster patches
     qmailconf - configure various /var/qmail/control/* files
      netqmail - installs netqmail 
    qmailadmin - installs qmailadmin
     sqwebmail - installs sqwebmail (webmail app)
       courier - installs courier imap & pop3 daemons
  squirrelmail - installs squirrelmail (webmail app)
        filter - installs SpamAssassin, ClamAV, DCC, razor, and more
        clamav - installs just ClamAV
  qmailscanner - installs Qmail-Scanner & qmailscanner stats
           qss - installs qmailscanner stats
     supervise - creates the directories to be used by svscan
      maillogs - creates the mail logging directories
       rrdutil - installs rrdutil
    mattbundle - install MATT::Bundle
       toaster - install Mail::Toaster
       socklog - installs socklog
           all - installs everything shown on the toaster INSTALL page


AUTHOR

        Matt Simerson <matt@tnpi.biz>


BUGS

        None known. Report any to author.


TODO

        Check if daemons are running before installs.
        Turn entire process into a ./install_it_all script
        Add -s dnscache section to install a DNS stub resolver


SEE ALSO

Mail::Toaster::CGI, Mail::Toaster::DNS, Mail::Toaster::Logs, Mail::Toaster::Qmail, toaster.conf Mail::Toaster::Setup, Mail::Toaster::Conf, toaster-watcher.conf

 http://matt.simerson.net/computing/mail/toaster/
 http://matt.simerson.net/computing/mail/toaster/faq.shtml
 http://matt.simerson.net/computing/mail/toaster/changelog.shtml


COPYRIGHT

Copyright (c) 2004, The Network People, Inc. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

Neither the name of the The Network People, Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.