Install programs
From The Network People, Inc.
Contents |
mail server software
If you want something installed "your way", then install it first and update toaster-watcher.conf accordingly. toaster_setup.pl will detect your installed version and use it.
toaster_setup.pl -s pre toaster_setup.pl -s mysql (optional) toaster_setup.pl -s ucspi toaster_setup.pl -s ezmlm toaster_setup.pl -s vpopmail toaster_setup.pl -s maildrop toaster_setup.pl -s qmail
webmail applications
Webmail applications are entirely optional, as is running a web server. They are however, quite convenient for users and administrators.
toaster_setup.pl -s webmail toaster_setup.pl -s apache | lighttpd toaster_setup.pl -s qmailadmin toaster_setup.pl -s vqadmin toaster_setup.pl -s squirrelmail toaster_setup.pl -s roundcube toaster_setup.pl -s sqwebmail
Edit mt-top.html to select which webmail interfaces are presented as options to your users. There is also support for v-webmail and Horde/IMP on the Mail Toaster login page but they must be manually installed.
Notes
MySQL Password Note
There are several places where the setup scripts will connect to the MySQL db server. If you have already installed MySQL and configured a root password, these database connections may fail. When this happens, the queries are printed out in your terminal and you must log into MySQL and run them manually.
The best solution for dealing with this is to store your MySQL credentials in ~/.my.cnf. Configure the user and pass in the [mysql] section, exactly as you would for the mysql client. For security, make sure the file is chmod 600!
FreeBSD notes
Some port installs throw up prompts. If you don't know what to select, see the notes section. Most of the options presented are optional and not required so if there is no note, just leave the defaults and continue.
If toaster_setup.pl has any problems running, fix what it complains about and then run it again. It will pick up where it left off. If you want something installed "your" way, install it yourself, configure toaster-watcher.conf accordingly, and continue. The installer will detect the installation and continue.
The default install method is now ports (instead of packages). You can alter this in toaster-watcher.conf. This default was changed due to compatibility problems with some packages on FreeBSD's servers (notably MySQL and SNMPd). The flip side is that it is typical that at least one of the thousands of FreeBSD ports is broken. When you find a port that won't compile, try installing the package (ie. "pkg_add -r expat" ) instead.
Darwin notes
You can skip the apache build step as you already have Apache installed. You will need to enable mod_php in httpd.conf as it is required by squirrelmail. Edit /etc/httpd/httpd.conf and uncomment mod_php.
Qmail note
More information about qmail is available in the qmail FAQ entry.
Misc. Qmail Trivia
Astute observers will notice that qmail has already been installed, and is being installed again. This is necessary to resolve a chicken and egg type problem. The version of qmail we want includes the chk-user patch and will check vpopmail to see if a users exists before accepting the message. In order to install, it has to link against the vpopmail libraries. Vpopmail depends on qmail, it will not install unless qmail exists first. To resolve this, we do a generic qmail installation, then install vpopmail, and finally re-install the highly customized version of qmail that we use.
