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

SPAMbaffle 4.0 Troubleshooting

If you run into trouble installing or configuring SPAMbaffle, please refer to the following before contact us for technical support.

The most up-to-date version of this document can be found on our website.

Problem Solutions
I run the installer, but some or all of the files are not copied to the locations I specify. Be sure that you are logged in as a user who has the necessary privileges to write to the directories you are specifying.
When I try load EditSPAMbaffle.cgi, I just get an error message.

Try adding the following line to the file named .htaccess which is located in the same directory as EditSPAMbaffle.cgi:

Options +ExecCGI

When I load EditSPAMbaffle.cgi, it gives me an error message about the directory not being password protected. You will need to figure out how to password protect the directory that contains EditSPAMbaffle.cgi. If the installer was not able to do this for you, please contact your webserver's administrator to find out how to do it.
When I try load EditSPAMbaffle.cgi, it asks for a password, but my password isn't accepted. Make sure you have a password set up in the password file indicated in .htaccess. If you don't, use the Apache program "htpasswd" to add one.
When I load EditSPAMbaffle.cgi and try to load my filtering rules file, it gives me an error message. Make sure that you have a subdirectory in your home directory named "SPAMbaffle".
Make sure that you have a file in your SPAMbaffle directory named ".SPAMbaffle". If not, create an EMPTY file with that name, or copy the default .SPAMbaffle file that came in the SPAMbaffle archive.
Make sure that the access permissions this ".SPAMbaffle" file are set properly to allow CGI scripts to modify it.
When load my filter settings in EditSPAMbaffle.cgi, the screen is filled with all kinds of gobbledygook. EditSPAMbaffle.cgi requires a modern web browser with support for CSS and DOM. If your browser does not support these standards correctly, you may need to use another browser to edit your settings.
When I click "edit" in EditSPAMbaffle.cgi nothing happens. Scripting (JavaScript, ECMAScript, etc.) must be enabled in your browser to use EditSPAMbaffle.cgi.
Everything seems to be set up correctly, but my email is not getting filtered. Make sure that you have a (hidden) file in your home directory named ".qmail".

Make sure that your ".qmail" file contains a line similar to this:

|/usr/bin/SPAMbaffle.pl

Make sure that SPAMbaffle.pl can be found in the location specified in the line mentioned above in your ".qmail" file.
Make sure that the access permissions for SPAMbaffle.pl are set correctly so that it can be executed by any user (755).
Make sure that you have a file in your home directory named ".SPAMbaffle" (or that you have specified a different location correctly as described in "Advanced Topics"). If you have used EditSPAMbaffle.cgi successfully to edit your filtering rules file, you may still need to copy it out of your SPAMbaffle directory and set it's access privileges so that other users can't modify it.
Everything seems to be set up correctly, and filtering is working, but I'm not getting any log entries. Make sure that you have a subdirectory in your home directory named "SPAMbaffle".
Make sure that the global logging setting in your filtering rules file is on, and that some of your filtering tests have logging turned on.
Make sure that your SPAMbaffle subdirectory contains a file named "SPAMbaffle.log" (or whatever name your log file is set to in your .SPAMbaffle (filter rules) file or as described in "Advanced Topics".
Make sure that the access permissions this log file are set properly to allow SPAMbaffle to modify it.
Everything was working fine for a few days, but now my SPAM isn't getting blocked anymore. If you have the trial version of SPAMbaffle installed, you will need to purchase and install the full version for it to work again. With the full version, you will also gain access to some of SPAMbaffle's advanced features which are not available in the trial version.