SPAMbaffle 4.0 Users Guide
SPAMbaffle Homepage| Features| System Requirements| Downloading & Registration| Installation| Configuration| Advanced Topics| Troubleshooting

SPAMbaffle 4.0 Installation

Installing SPAMbaffle

  1. Download the SPAMbaffle archive.
  2. Upload it to your email server using FTP, SCP, or your preferred file transfer tool.
  3. Log into the server using telnet, SSH, or some other terminal program, and go to the directory to which you copied the archive.
  4. Unpack the archive by typing "tar -xzvf SPAMbaffle-4.0.3.tar.gz".
  5. Type "./install" and press the return key (if the installation program does not start, type "chmod 755 install" and then try again).
  6. Follow the instructions that appear on the screen.

Installation notes
The following options may be displayed during installation, depending on the options you select:


Prompt Notes
"There are 3 ways to run this installation program..." If you select option 3, you should be logged in with superuser privileges. Otherwise, you may not have write access to some of the directories where you will need to install files.
"The Perl interpreter is not in the expected or indicated location..." The Perl interpreter on most systems can be found at /usr/bin/perl. If this is not the case on your system, you will need to indicate the full path to your Perl interpreter so that the installer can patch some of SPAMbaffle's executable files.
"Specify home directory location..." On most systems, this should be "/home". On systems with many users, sometimes users are grouped into subdirectories beneath /home rather than simply having their user directories located inside /home. In this case, you should still simply indicate "/home".
"Specify CGI directory..." This directory will be password protected, so it should NOT simply be your cgi-bin directory, but should be a subdirectory inside cgi-bin.
"Specify SPAMbaffle program location" If SPAMbaffle is to be used by multiple users on your system, we recommend that SPAMbaffle.pl and other executable programs be installed into /usr/bin. However, you may install them in any location where any user will be able to access them.
"Specify directory location for global filtering rules files" Whether you are initally planning to use global filtering rules or not, please specify a location to store such files.
"Automated password protection setup..." If your webserver runs Apache and allows users to change password protection settings using ".htaccess" files, the installer can create an .htaccess file in the CGI directory to set up password protection. If not, you must set up password protection by some other method.
"Specify password file..."

You may wish to use a password file to control access to SPAMbaffle's CGIs which is not used for any other purpose.

It may be possible to use the system password file if your users' home directories are located immediately inside the home directory location specified earlier, for example, /home/username. If not (for example, if they are grouped in subdirectories like /home/u/username), you will need a separate password file where each username combined with the common part of the home path completes the path to their user folder. For example, users may need to log in to SPAMbaffle's scripts as "u/username" instead of just "username".


Upgrading from version 3.x

To upgrade from version 3.x:

  1. Make a backup copy of your filtering rules file(s).
  2. Run the verion 4.x installer as described above.
  3. Load SPAMbaffleConvertRules.cgi in your web browser (it will be in your password protected CGI directory, along with EditSPAMbaffle.cgi and SPAMbaffleLog.cgi).
  4. Specify the name of your filtering rules file, and click "Convert".
  5. Load EditSPAMbaffle.cgi and add filtering rules to start taking advantage of the our features.

Upgrading from version 4.x trial to 4.x full

To upgrade from the trial version to the full version, either re-run the installer or:

  1. Using a text editor (not a word processor like Microsoft Word, but a program that only edits plain text files), copy the section at the top of the trial version of SPAMbaffle.pl between ######## CONFIGURATION ######## and ######## NO CHANGES ARE NEEDED BELOW THIS POINT ########, and paste it in over the same section in the full version.
  2. Copy the full version of SPAMbaffle.pl over the top of the old one (you may wish to make a backup copy first).
  3. Do the same with EditSPAMbaffle.cgi.