mail.txt

   1 AUTHOR:         Jim Gifford <lfs-hints@jg555.com>
   2
   3 DATE:           2003-10-09
   4
   5 LICENSE:        GNU Free Documentation License Version 1.2
   6
   7 SYNOPSIS:       Howto setup a complete email system.
   8
   9 DESCRIPTION:    This hint will show you how to completly set
  10                 up an email system under LFS
  11
  12 PREREQUISITES:  Files listed in hint must be downloaded
  13
  14 HINT:
  15
  16 Introduction to Complete Email
  17
  18 This hint will help you configure a complete email system. One that supports
  19 IMAP and POP3 requests. It will also filter SPAM and remove harmfull HTML code
  20 from messages. This is a very long hint, but in order to get everything to work
  21 you must follow all steps.
  22
  23 Programs Used
  24
  25 Program Name            Postfix
  26 Download location               http://www.postfix.org
  27 Version used            2.0.15
  28
  29 Program Name            Procmail
  30 Download location               http://www.procmail.org
  31 Version used            3.22
  32
  33 Program Name            Courier Imap
  34 Download location               http://www.courier-mta.org
  35 Version used            2.1.1
  36
  37 Program Name            Avmailgate
  38 Download location               http://www.hbedv.com
  39 Version used            2.0.1.16
  40
  41 Program Name            Gotmail
  42 Download location               http://ssl.usu.edu/paul/gotmail
  43 Version used            0.7.10
  44
  45 Program Name            Fetchmail
  46 Download location               http://www.tuxedo.org/~esr/fetchmail
  47 Version used            6.2.4
  48
  49 Program Name            Anomy Mail Sanitzer
  50 Download location               http://mailtools.anomy.net
  51 Version used            1.6.3
  52
  53 Program Name            Spam Assassin
  54 Download location               http://www.spamassassin.org
  55 Version used            2.55
  56
  57 Program Name            Razor
  58 Download location               http://razor.sourceforge.net
  59 Version used            2.36
  60
  61 Program Name            Imap Filter
  62 Download location               http://imapfilter.hellug.gr
  63 Version used            0.9.2
  64
  65 Program Name            FCRON
  66 Download location               http://fcron.free.fr
  67 Version used            2.0.0
  68
  69 Program Name            Berkeley DB
  70 Download location               http://www.sleepycat.com
  71 Version used            4.0.14
  72
  73 Program Name            Wget
  74 Download location               http://www.gnu.org/software/wget/wget.html
  75 Version used            1.8.2
  76
  77 Program Name            Nail
  78 Download location               http://omnibus.ruf.uni-freiburg.de/~gritter
  79 Version used            10.5
  80
  81 Program Name            Openssl
  82 Download location               http://www.openssl.org
  83 Version used            0.9.7b
  84
  85 Program Name            Pop-before-smtp
  86 Download location               http://www.trestle.com/unix/pop-before-smtp
  87 Version used            0.91
  88
  89 ---
  90 Assumptions Made in this document
  91
  92         I have made the following assumptions in this document.
  93         File have been downloaded.
  94         The use of tar.
  95         Openssl is installed. Install information is located in this document also.
  96
  97 ---
  98 Important
  99
 100         The complete mail system will not be functional until you have
 101         completed all the steps. You can skip the steps that are optional,
 102         without any problems
 103
 104         DO NOT USE DB 4.1.25 IT DOES NOT WORK WITH THIS CONFIGURATION.
 105
 106 ---
 107 Postfix
 108
 109         Before you can setup Postfix you will need to setup Berkeley DB.
 110
 111         Setup of Berkeley DB
 112
 113                 To Compile Berekely DB you can use the following commands.
 114
 115                 Change to the /usr/src/db-4.014/dist directory
 116                 In the directory issue the following commands
 117
 118                 ./configure --prefix=/usr --enable-shared -- enable-compat185
 119                 make docdir=/usr/doc/BerkeleyDB-4 all install
 120
 121         This completes the Setup of Berkeley DB. You can remove the db-4.0.14
 122         file and directory.
 123
 124 Before Compiling
 125
 126         Before compiling postfix you will need to create a user and a group.
 127
 128         In /etc/passwd add : postfix:x:101:101::/dev/null:/bin/false
 129
 130         In /etc/group add : postfix:x:101: postdrop:x:102:
 131
 132 Compiling
 133
 134         Change to /sr/src/postfix-1.1.11 directory
 135         In the directory issue the following commands
 136
 137         make
 138
 139         Now if you have never installed Postfix before the next command you
 140         will issue is the following command. You may want to look at the
 141         configuration information beelow, it may help you answer some of
 142         question that postfix will ask you.
 143
 144         make install
 145
 146         If you have installed Postfix before the next command you will issue
 147         is the following command
 148
 149         make upgrade
 150
 151 Configuration
 152
 153         You will need to change postfix's configuration to work with the
 154         courier-imap server. The configuration below is my working config. I
 155         have added *** *** lines where changes are needed
 156
 157         Configuration File Main.cf - /etc/postfix/main.cf
 158
 159         queue_directory = /var/spool/postfix
 160         command_directory = /usr/sbin
 161         daemon_directory = /usr/libexec/postfix
 162         mail_owner = postfix
 163         myhostname = mail.server.com *** Change this to your mail server DNS Name ***
 164         mydomain = server.com *** Change this to your domain name ***
 165         myorigin = $mydomain
 166         inet_interfaces = all
 167         mydestination = $myhostname, localhost.$mydomain, $mydomain,
 168                 mail.$mydomain, www.$mydomain, ftp.$mydomain
 169         mynetworks_style = subnet
 170         mynetworks = 192.168.0.0/24, 127.0.0.0/8 *** Change this to your Network IP -- Do not Change the 127.0.0.0/8 ***
 171         relayhost = [ smtp.isp.com ]  *** Change this to your ISP's smtp server ***
 172         allow_percent_hack = yes
 173         append_at_myorigin = yes
 174         append_dot_mydomain = yes
 175         empty_address_recipient = MAILER-DAEMON
 176         masquerade_classes = envelope_sender, header_sender, header_recipient
 177         masquerade_domains = server.com *** Change this to your domain name ***
 178         masquerade_exceptions =
 179         swap_bangpath = yes
 180         transport_maps = hash:/etc/postfix/transport
 181         alias_maps = hash:/etc/postfix/aliases
 182         alias_database = hash:/etc/postfix/aliases
 183         home_mailbox = Maildir/
 184         mail_spool_directory = /var/mail
 185         mailbox_command = /usr/bin/procmail -d "$USER"
 186         smtpd_banner = $myhostname ESMTP $mail_name ($mail_version)
 187         debug_peer_level = 2
 188         debugger_command =
 189                 PATH=/usr/bin:/usr/X11R6/bin
 190                  xxgdb $daemon_directory/$process_name $process_id & sleep 5
 191         sendmail_path = /usr/sbin/sendmail
 192         newaliases_path = /usr/bin/newaliases
 193         mailq_path = /usr/bin/mailq
 194         setgid_group = postdrop
 195         manpage_directory = /usr/share/man
 196         sample_directory = /etc/postfix/sample
 197         readme_directory = no
 198         content_filter = smtp:127.0.0.1:10024
 199         maps_rbl_reject_code = 571
 200         maps_rbl_domains = dynablock.wirehub.net, blackholes.wirehub.net, relays.ordb.org
 201         smtpd_sender_restrictions = hash:/etc/postfix/access, reject_maps_rbl
 202
 203         Configuration File Master.cf - /etc/postfix/master.cf
 204
 205         Use the file that is in /etc/postfix directory and add the following
 206         line after smtp
 207
 208         localhost:smtp-backdoor         inet    n       -       n       -       -       smtpd -o content_filter=
 209
 210         Configuration File Aliases - /etc/postfix/aliases
 211
 212         You will need to configure the aliases file to your needs, the default
 213         should be fine. The import thing to remember is after you make changes
 214         to this file, you will need to run the newaliases command for that file
 215         to be in effect. Important note: You will need to create a user for the
 216         root email account. By using procmail we have disabled the root mail
 217         account. I suggest the account name of admin. Add the following to your
 218         aliases file.
 219
 220         root: admin
 221
 222         Configuration File Transport - /etc/postfix/transport
 223
 224         This file is how every mail is handled by your domain. You will need to
 225         change *** *** lines where changes are needed. The import thing to remember
 226         is after you make changes to this file, you will need to run the postmap
 227         /etc/postfix/transport command for that file to be in effect.
 228         .server.com              local:  *** Change this to your domain name ***
 229         localhost                       local:
 230
 231         Configuration File Access - /etc/postfix/spam_access_list
 232
 233         This file I made a cron event. If you have already installed FCRON or
 234         another cron program all you need to do is run the following script.
 235         This file is for a spam protection. At the end of this file I have
 236         added a fcron and wget instructions. You will need to run this file
 237         manually one time. This will create the first access file.
 238
 239         #!/bin/bash
 240
 241         clear
 242         cd /tmp
 243         echo "Getting SPAM Access list..."
 244         wget http://basic.wirehub.nl/spamlist-extended.txt
 245         echo "Moving SPAM Access list to Postfix Directory..."
 246         mv /tmp/spamlist-extended.txt /etc/postfix/access
 247         echo "Enabling SPAM Access list in Postfix..."
 248         postmap /etc/postfix/access
 249
 250         Start-up Script
 251
 252         #!/bin/bash
 253         # Begin $rc_base/init.d/postfix
 254
 255         # Based on sysklogd script from LFS-3.1 and earlier.
 256         # Rewritten by Gerard Beekmans  - gerard@linuxfromscratch.org
 257
 258         source /etc/sysconfig/rc
 259         source $rc_functions
 260
 261         case "$1" in
 262                 start)
 263                         echo "Starting Postfix..."
 264                         /usr/sbin/postfix start > /dev/null 2>&1
 265                         evaluate_retval
 266                         ;;
 267
 268                 stop)
 269                         echo "Stopping Postfix..."
 270                         /usr/sbin/postfix stop > /dev/null 2>&1
 271                         evaluate_retval
 272                         ;;
 273
 274                 reload)
 275                         echo "Reloading Posfix..."
 276                         /usr/sbin/postfix reload > /dev/null 2>&1
 277                         evaluate_retval
 278                         ;;
 279
 280                 restart)
 281                         $0 stop
 282                         sleep 1
 283                         $0 start
 284                         ;;
 285                 *)
 286                         echo "Usage: $0 {start|stop|reload|restart}"
 287                         exit 1
 288                         ;;
 289         esac
 290
 291         # End $rc_base/init.d/postfix
 292
 293         Runlevels - You will need to select the runlevel you want to run
 294         postfix at. Use the the following command to achieve this. Change
 295         the ?? to the # you want to use.
 296
 297         ln -sf /etc/rc.d/init.d/postfix /etc/rc.d/init.d/rc0.d/K??postfix
 298         ln -sf /etc/rc.d/init.d/postfix /etc/rc.d/init.d/rc3.d/S??postfix
 299         ln -sf /etc/rc.d/init.d/postfix /etc/rc.d/init.d/rc4.d/S??postfix
 300         ln -sf /etc/rc.d/init.d/postfix /etc/rc.d/init.d/rc5.d/S??postfix
 301         ln -sf /etc/rc.d/init.d/postfix /etc/rc.d/init.d/rc6.d/K??postfix
 302
 303 ---
 304 Procmail
 305
 306         Compiling
 307
 308         You will need to edit the autenticate.c file before compiling. This
 309         will make procmail work with Maildir style mailboxes.
 310
 311         Change to the /usr/src/procmail-3.22/src directory
 312
 313         cp authenticate.c authenticate.c.backup
 314         sed -e 's|#define MAILSPOOLHOME "/.mail"|#define MAILSPOOLHOME "/Maildir/"|g' \
 315               authenticate.c.backup > authenticate.c
 316
 317         Change to the /usr/src/procmail-3.22 directory
 318         echo "" | make BASENAME=/usr install
 319
 320         More information will be discussed in the Procmail Recipes section
 321
 322 ---
 323 Courier-Imap
 324
 325         Compiling
 326
 327         Change to the /usr/src/courier-imap-1.4.6 directory
 328
 329         These commands need to be run by a user other than root.
 330
 331         ./configure --prefix=/usr/courier \
 332                   --sysconfdir=/etc/courier \
 333                   --with-piddir=/var/run \
 334                   --with-authshadow \
 335                   --without-authpam \
 336                         --without-authuserdb \
 337                     --without-authmysql \
 338                   --enable-workarounds-for-imap-client-bugs
 339         make
 340
 341         These commands need to be run by the root users
 342
 343         make install
 344         make install-configure
 345
 346         Configuration Files
 347
 348         Configuration File - /etc/courier/imapd
 349
 350         Edit this file. The last line of the file has the following information in it.
 351
 352         IMAPDSTART=NO
 353
 354         Change this to =YES
 355
 356         If you also want a POP3 server edit - /etc/courier/pop3d
 357
 358         The last line of the file has the following information in it.
 359
 360         POP3DSTART=NO
 361
 362         Change this to =YES
 363
 364         Configuration File - /etc/courier/authdaemonrc
 365
 366         Verify that the authmodulelist="authshadow"
 367
 368         Start-up Scripts
 369
 370         cp /usr/courier/libexec/imapd.rc /etc/rc.d/init.d/courier-imap
 371         cp /usr/courier/libexec/pop3d.rc /etc/rc.d/init.d/courier-pop3
 372
 373         Runlevels - You will need to select the runlevel you want to run
 374         courier at. Use the following command to achieve this. Change the
 375         ?? to the # you want to use.
 376
 377         ln -sf /etc/rc.d/init.d/courier-imap /etc/rc.d/init.d/rc0.d/K??courier-imap
 378         ln -sf /etc/rc.d/init.d/courier-imap /etc/rc.d/init.d/rc3.d/S??courier-imap
 379         ln -sf /etc/rc.d/init.d/courier-imap /etc/rc.d/init.d/rc4.d/S??courier-imap
 380         ln -sf /etc/rc.d/init.d/courier-imap /etc/rc.d/init.d/rc5.d/S??courier-imap
 381         ln -sf /etc/rc.d/init.d/courier-imap /etc/rc.d/init.d/rc6.d/K??courier-imap
 382
 383         ln -sf /etc/rc.d/init.d/courier-pop3 /etc/rc.d/init.d/rc0.d/K??courier-pop3
 384         ln -sf /etc/rc.d/init.d/courier-pop3 /etc/rc.d/init.d/rc3.d/S??courier-pop3
 385         ln -sf /etc/rc.d/init.d/courier-pop3 /etc/rc.d/init.d/rc4.d/S??courier-pop3
 386         ln -sf /etc/rc.d/init.d/courier-pop3 /etc/rc.d/init.d/rc5.d/S??courier-pop3
 387         ln -sf /etc/rc.d/init.d/courier-pop3 /etc/rc.d/init.d/rc6.d/K??courier-pop3
 388
 389 ---
 390 Avmailgate
 391
 392         For security reasons this package cannot be compiled. This will give you
 393         complete antivirus protection.
 394
 395         You can get a free license for this program. You apply for it at
 396         http://www.antivir.de/order/privreg/order_e.htm
 397
 398         This will get you a key file.
 399
 400         Installation
 401
 402         Change to the /usr/src/avmailgate-2.0.0.6-Linux-glibc directory
 403
 404         ./avinstall.pl
 405
 406         This will ask you a series of questions. These questions relate to
 407         you specific system setup.
 408
 409 ---
 410 Gotmail
 411
 412         This is an optional program that will pull mail from Hotmail.
 413
 414         Installation
 415
 416         Change to the /usr/src directory
 417
 418         mv gotmail-0.7.0 gotmail
 419         mv gotmail /usr
 420         cd /usr/gotmail
 421         mv *.1 /usr/share/man/man1
 422
 423         In the Cron section I will show you how to use this program.
 424
 425 ---
 426 Fetchmail
 427
 428         This is an optional program that will pull mail from a POP3 server.
 429
 430         Compiling
 431
 432         Change to the /usr/src/fetchmail-5.9.13 directory
 433
 434         ./configure --prefix=/usr \
 435                   --enable-fallback=procmail \
 436                       --with-ssl=/usr \
 437                   --sysconfdir=/etc
 438         make
 439         make install
 440
 441         Configuration Files
 442
 443         Config File - /~/fetchmail.rc
 444
 445         # Begin /~/.fetchmailrc
 446
 447         # Global Options
 448
 449         set logfile /var/log/fetchmail.log
 450
 451         # Get mail from ISP.com
 452
 453         poll ISP.com
 454         proto pop3
 455         user "isp_username"
 456         pass "isp_password"
 457         flush
 458         is local_username here password local_password
 459
 460         # End /~/.fetchmailrc
 461
 462         In the Cron section I will show you how to use this program.
 463
 464         More information will be discussed in the Procmail Recipes section
 465
 466 ---
 467 Anomy Mail Sanitzer
 468
 469         Installation
 470
 471         Change to the /usr/src directory
 472
 473         mv anomy /usr
 474         chmod 750 /usr/anomy
 475
 476         Configuration File
 477
 478         # Configuration file for Anomy Sanitizer
 479         #
 480
 481         # Do not log to STDERR:
 482         feat_log_stderr = 0
 483
 484         # Don't insert log in the message itself:
 485         feat_log_inline = 0
 486
 487         # Advertisement to insert in each mail header:
 488         header_info = X-Sanitizer: This mail was sanitized
 489         header_url = 0
 490         header_rev = 0
 491
 492         # Enable filename based policy decisions:
 493         feat_files = 1
 494
 495         # Protect against buffer overflows and null values:
 496         feat_lengths = 1
 497
 498         # Replace MIME boundaries with our own:
 499         feat_boundaries = 1
 500
 501         # Fix invalid and ambiguous MIME boundaries, if possible:
 502         feat_fixmime = 1
 503
 504         # Trust signed and/or encrypted messages:
 505         feat_trust_pgp = 1
 506         msg_pgp_warning = WARNING: Unsanitized content follows.\n
 507
 508         # Defang shell scripts:
 509         feat_scripts = 0
 510
 511         # Defang active HTML:
 512         feat_html = 1
 513
 514         # Defang UUEncoded files:
 515         feat_uuencoded = 0
 516
 517         # Sanitize forwarded content too:
 518         feat_forwards = 1
 519
 520         # Testing? Set to 1 for testing, 0 for production:
 521         feat_testing = 0
 522
 523         ## Warn user about unscanned parts, etc.
 524         feat_verbose = 1
 525
 526         # Force all parts (except text/html parts) to
 527         # have file names.
 528         feat_force_name = 1
 529
 530         # Disable web bugs:
 531         feat_webbugs = 1
 532
 533         # Disable "score" based mail discarding:
 534         score_panic = 0
 535         score_bad = 0
 536
 537         msg_file_drop  = \n*****\n
 538         msg_file_drop += NOTE: An attachment named %FILENAME was deleted from
 539         msg_file_drop += this message because was a windows executable.
 540         msg_file_drop += Contact the system administrator for more information.
 541
 542         ##
 543         ## File attachment name mangling rules:
 544         ##
 545
 546         file_name_tpl       = /var/quarantine/att-$F-$T.$$
 547
 548         # Number of rulesets we are defining:
 549         file_list_rules = 2
 550         file_default_policy = defang
 551
 552         # Delete probably nasty attachments:
 553         file_list_1 = (?i)(winmail.dat)|
 554         file_list_1 += (\.(vb[se]|exe|com|cab|dll|ocx|msi|cmd|bat|pif|lnk|hlp|ms[ip]|reg|asd))$
 555         file_list_1_policy = drop
 556         file_list_1_scanner = 0
 557
 558         # Allow known "safe" file types and those that can be
 559         # scanned by the downstream virus scanner:
 560         file_list_2 = (?i)\.(doc|dot|rtf|xls|ppt|xlw|jpg|gif|png|tiff?|txt|zip|tgz|gz)
 561         file_list_2_policy = accept
 562         file_list_2_scanner = 0
 563
 564         # Any attachment not listed above gets renamed.
 565
 566         More information will be discussed in the Procmail Recipes section
 567
 568 ---
 569 Spamassassin and Razor
 570
 571         Change to the /usr/src/razor-agents-2.14 directory
 572
 573         perl Makefile.PL
 574         make
 575         make -s install
 576
 577         Change to the /usr/src/Mail-SpamAssassin-2.31 directory
 578
 579         perl Makefile.PL
 580         make
 581         make -s install
 582
 583         Configuration File
 584
 585         /etc/mail/spamassassin/local.cf file you may need to specify email
 586         addresses that are exempt from spam checking. Example to allow all
 587         emails from joe@isp.com you would add the following line to the
 588         local.cf file
 589
 590         whitelist_from joe@isp.com
 591
 592 ---
 593 Creating Maildirs
 594
 595         I will be using the user admin as the example here. You will need to
 596         do this for all the users that you want to give mail access to. If
 597         you run this command as root you will need to change the file
 598         permissions to the maildir manually, using the following chmod
 599         utilizing 700 and chown user.user -R
 600
 601         Now we are getting to the actual mail directories. First you will
 602         need to create a default mail directory.
 603
 604         maildirmake /home/admin/Maildir
 605
 606         This will create the main mail directory. Since we are also using
 607         spam checking I would also create a Spam folder. Type it exactly
 608         like this.
 609
 610         maildirmake /home/admin/Maildir/.Spam
 611
 612 ---
 613 Procmail Recipes
 614
 615         The procmail recipe I use will sort the mail, sanitize, and spam
 616         check all the emails that enter the system. This file will need
 617         to be in all of the users home directory. Permissions on this
 618         file must be set with the chmod utilizing 644.
 619
 620         .procmailrc
 621
 622         # Begin /~/.procmailrc
 623
 624         # Prelimiaries
 625         SHELL=/bin/bash
 626         MAILDIR=$HOME/Maildir/
 627         DEFAULT=$MAILDIR
 628         ORGMAIL=$MAILDIR
 629         LOGFILE=/var/log/procmailrc.log
 630         VERBOSE=yes
 631         LOGABSTRACT=all
 632         ANOMY=/usr/anomy
 633
 634         :0:
 635         * ^From:.*\<*@server.com> # Change server.com to your domain. This will bypass all
 636         $DEFAULT                  # check if the mail is from the localdomain.
 637
 638         :0fw
 639         | /usr/anomy/bin/sanitizer.pl /usr/anomy/anomy.conf
 640
 641         :0fw
 642         * < 256000
 643         | spamassassin
 644
 645         :0:
 646         * ^X-Spam-Status: Yes
 647         $MAILDIR.Spam/
 648
 649         # Accept all the rest to default mailbox
 650         :0
 651         $DEFAULT
 652
 653         # End /~/.procmailrc
 654
 655         You can also have it sort email that come in from the gotmail and
 656         fetchmail script. Here is a modified procmailrc file that will sort
 657         emails from gotmail and fetchmail. You will have to issue an additonal
 658         makemaildir command. Here is the command line for the examples I show.
 659
 660         maildirmake /home/admin/Maildir/.Hotmail
 661         maildirmake /home/admin/Maildir/.isp
 662         maildirmake /home/admin/Maildir/.isp2
 663
 664         After you have made the Maildir directories make sure that the user
 665         that owns then is the same user that the mail is intended for. In
 666         this case
 667
 668         chown admin.admin /home/admin/Maildir -R
 669         chmod 700 /home/admin/Maildir -R
 670
 671         Here is the recipe
 672
 673         # Begin /~/.procmailrc
 674
 675         # Prelimiaries
 676         SHELL=/bin/bash
 677         MAILDIR=$HOME/Maildir/
 678         DEFAULT=$MAILDIR
 679         ORGMAIL=$MAILDIR
 680         LOGFILE=/var/log/procmailrc.log
 681         VERBOSE=yes
 682         LOGABSTRACT=all
 683         ANOMY=/usr/anomy
 684
 685         :0:
 686         * ^From:.*\<*@server.com> # Change server.com to your domain. This will bypass all
 687         $DEFAULT                  # check if the mail is from the localdomain.
 688
 689         :0fw
 690         | /usr/anomy/bin/sanitizer.pl /usr/anomy/anomy.conf
 691
 692         :0fw
 693         * < 256000
 694         | spamassassin
 695
 696         :0:
 697         * ^X-Spam-Status: Yes
 698         $MAILDIR.Spam/
 699
 700         :0:
 701         * ^TO_user@hotmail.com
 702         $MAILDIR.Hotmail/
 703
 704         :0:
 705         * ^TO_user@isp.com
 706         $MAILDIR.isp/
 707
 708         :0:
 709         * ^TO_user@isp2.com
 710         $MAILDIR.isp2/
 711
 712         # Accept all the rest to default mailbox
 713         :0
 714         $DEFAULT
 715
 716         # End /~/.procmailrc
 717
 718 ---
 719 Imap Filter
 720
 721         This program will allow you to filter IMAP messages like procmail,
 722         but that is not why I use it. It also allows you to delete emails
 723         that are old. The imapfilterrc file must chmod with 700 and belong
 724         to the user who's home dir it is in.
 725
 726         Compiling
 727
 728         Change to the /usr/src/imapfilter-0.7.3 directory
 729
 730         cp Makefile Makefile.org
 731         sed -e 's|/usr/local|/usr|g' \
 732                  Makefile.org > Makefile
 733         make
 734         make install
 735
 736         Configuration File
 737
 738         The only catch to this configuration file is that it requires a
 739         username and password. It lives in the home directory of the users.
 740         This will only delete the messages older than 7 days from the Spam
 741         folder only. It will not touch the INBOX
 742
 743         ###########
 744         # Options #
 745         ###########
 746         #
 747         # Some program options, such as log file and non-response server timeout.
 748         #
 749         logfile = /var/log/imapfilter.log
 750         set timeout = 120
 751         expunge = yes
 752         subscribe = no
 753
 754         ##########################
 755         # Accounts and mailboxes #
 756         ##########################
 757         #
 758         # Each account has a number of folders/mailboxes which are grouped under
 759         # an alias name. Folders belong to the last preceding account. A mailbox
 760         # can belong to many mailbox groups.
 761         #
 762
 763         #
 764         # Connects to "imap1.mail.server" at port 143, as "user1" and
 765         # using password "secret1".
 766         #
 767         # Mailboxes that exist at "imap1.mail.server" include: "INBOX", "woody",
 768         # "linux-mailist", etc. and are grouped in various ways.
 769         #
 770         account account1 username:password@mail.server.com:143
 771           folder inbox INBOX
 772           folder spam Spam
 773
 774         ###########
 775         # Filters #
 776         ###########
 777         #
 778         # Filters are completely independent from any account or folder settings.
 779         # The mask command may be ommited. If no masks are declared inside
 780         # a filter entry, then all messages are matched.
 781         #
 782
 783         filter 7days
 784         older 7
 785         action delete
 786
 787         ########
 788         # Jobs #
 789         ########
 790         #
 791         # Last, there is the definition of the jobs where user combines
 792         # folders and filters _already_ defined, and specifies which filters
 793         # should be applied to which folders.
 794         #
 795
 796         job 7days spam
 797
 798 ---
 799 Wget
 800
 801         This will give a basic setup for wget.
 802
 803         ./configure --prefix=/usr \
 804                   --sysconfdir=/etc/wget
 805         make
 806         make install
 807
 808         Some users may need to change the #passive_ftp = off to passive_ftp = on
 809
 810 ---
 811 Nail
 812
 813         This will give a basic setup for nail. Do to the setup, this is only
 814         used to send email and not to receive. Nail is not Maildir compatible.
 815         You can use mutt or pine to read emails from a IMAP folder
 816
 817         ./configure --prefix=/usr \
 818                   --with-sendmail=/usr/sbin/sendmail
 819         make
 820         make install
 821         ln -sf /usr/bin/nail /usr/bin/mail
 822
 823
 824 ---
 825 Fcron
 826
 827         This will give a basic setup for fcron. Follow the fcron instruction
 828         during the fcron installation process
 829
 830         Compiling
 831
 832         ./configure --prefix=/usr \
 833                   --enable-shared \
 834                   --with-sendmail=/usr/sbin \
 835                   --with-piddir=/var/run \
 836                   --sysconfdir=/etc/fcron
 837         make
 838         make install
 839
 840         Mail Related Cron Events
 841
 842         To update the spamlist use the following commands as root
 843
 844         fcrontab -u root -e
 845
 846         add the following line
 847
 848         %hourly 01      /etc/postfix/spam_access_list
 849
 850         To use gotmail to get Hotmail and fetchmail to get other ISP's mail
 851
 852         fcrontab -u user -e
 853
 854         add the following line
 855
 856         %hourly 02      /usr/gotmail/gotmail -u username -p password -f linuxusername@server.com --delete --silent
 857         %hourly 03      /usr/bin/fetchmail
 858
 859         To use imapfilter to delete old messages
 860
 861         fcrontab -u user -e
 862
 863         %nightly 00 01  /usr/bin/imapfilter
 864
 865
 866 ---
 867 Openssl
 868
 869         This will setup openssl to work with Courier and Fetchmail
 870
 871         Change to /usr/src/openssl-0.9.6d directory
 872
 873         ./config --prefix=/usr --openssldir=/etc/openssl shared
 874         make MANDIR=/usr/man
 875         make MANDIR=/usr/man install
 876
 877 ---
 878 Optional program pop-before smtp
 879
 880         This program allow your remote users to send email from a remote
 881         location. It allows this by capturing their current IP after they
 882         have done a POP or IMAP transfer from courier. The IP only stays
 883         active for a time that you have setup.
 884
 885         Here is the basic compile and configuration for pop-before-smtp
 886
 887         make -s
 888         make -s install
 889         cd /etc/postfix
 890         cp pop-before-smtp.conf pop-before-smtp.conf.org
 891         sed -e 's|grace = 2h|grace = 30m|g' \
 892             -e 's|log_file = /var/log/mail.log|log_file = /var/log/mail.log|g' \ # Change to your log file
 893             pop-before-smtp.conf.org > pop-before-smtp.conf
 894         rm -rf pop-before-smtp.conf.org
 895
 896         Now you will need to configure postfix to use the file
 897
 898         You will need to edit your main.cf file and add the following line
 899         smtpd_recipient_restrictions = permit_mynetworks, check_client_access hash:/etc/postfix/pop-before-smtp, check_relay_domains
 900
 901         Start-up Script
 902
 903         #!/bin/bash
 904         # Begin $rc_base/init.d/pop-before-smtp
 905
 906         # Based on sysklogd script from LFS-3.1 and earlier.
 907         # Rewritten by Gerard Beekmans  - gerard@linuxfromscratch.org
 908
 909         source /etc/sysconfig/rc
 910         source $rc_functions
 911
 912         case "$1" in
 913                 start)
 914                         echo "Clearing POP Before SMTP File..."
 915                         rm -rf /etc/postfix/pop-before-smtp
 916                         evaluate_retval
 917                         echo "Starting POP Before SMTP..."
 918                         /usr/bin/pop-before-smtp &
 919                         evaluate_retval
 920                         ;;
 921
 922                 stop)
 923                         echo "Stopping Pop Before SMTP..."
 924                         killproc /usr/bin/pop-before-smtp
 925                         ;;
 926
 927                 restart)
 928                         $0 stop
 929                         sleep 1
 930                         $0 start
 931                         ;;
 932
 933                 status)
 934                         statusproc
 935                         ;;
 936
 937                 *)
 938                         echo "Usage: $0 {start|stop|restart|status}"
 939                         exit 1
 940                         ;;
 941         esac
 942
 943         # End $rc_base/init.d/pop-before-smtp
 944
 945
 946         Runlevels - You will need to select the runlevel you want to run
 947         pop-before-smtp at. Use the following command to achieve this.
 948         Change the ?? to the # you want to use.
 949
 950         ln -sf /etc/rc.d/init.d/pop-before-smtp /etc/rc.d/init.d/rc0.d/K??pop-before-smtp
 951         ln -sf /etc/rc.d/init.d/pop-before-smtp /etc/rc.d/init.d/rc3.d/S??pop-before-smtp
 952         ln -sf /etc/rc.d/init.d/pop-before-smtp /etc/rc.d/init.d/rc4.d/S??pop-before-smtp
 953         ln -sf /etc/rc.d/init.d/pop-before-smtp /etc/rc.d/init.d/rc5.d/S??pop-before-smtp
 954         ln -sf /etc/rc.d/init.d/pop-before-smtp /etc/rc.d/init.d/rc6.d/K??pop-before-smtp
 955
 956 ---
 957 Notes
 958
 959         --- Outlook Express ---
 960
 961         If you are using Outlook Express Clients. Here is how you would
 962         configure them.
 963
 964         Setup an IMAP account. Follow the prompts until you get a message.
 965         Would you like to Download folders from the mail server you added.
 966         Click on NO. If you have not exited from the account creation screen
 967         you can continue to the next step.
 968
 969         Then go to Tools -=> Accounts -=> Select the Account You just made -=> Properties
 970
 971         Go to the IMAP tab. In the Root folder path type INBOX.
 972
 973         --- Pine 4.10 or greater ---
 974
 975         Go to Pine's Main Menu. Select Setup then Configure. Go down to "inbox-path" setting
 976         set it (hostname) INBOX
 977
 978         --- Netscape Messenger ---
 979
 980         Uncheck the opton Show only subscribed folders in the Advanced tab.
 981
 982         Under "Personal Namespace" enter "INBOX."
 983
 984         --- Shared Folders ---
 985
 986         If you are using shared folders the same steps apply, but I would create
 987         a separate account and using the above information. All you have to do
 988         is change INBOX to SHARED.
 989
 990 ---
 991 Common Problems
 992
 993         Here are the necessary permissions needed for some of the rc files
 994         and the commands to correct them.
 995
 996         chmod 600 .procmailrc
 997         chmod 710 .fetchmailrc
 998         chmod 600 .imapfilterrc
 999
1000         Here are the necssary permissions for unifed logging of all of the
1001         programs listed
1002
1003         chmod 666 /var/log/procmail.log
1004         chmod 666 /var/log/imapfilter.log
1005         chmod 666 /var/log/fetchmail.log
1006         chmod 666 /var/log/anomy.log
1007
1008 VERSION:        1.7
1009
1010 CHANGELOG:      1.7 Update CVS Information
1011                 1.6 Update to New Hint Format Completed
1012                 1.5 Updated Email Address
1013                 1.4 Updated to New Hint Format
1014                 1.3 Updated versions
1015                 1.2 Fixed Typos
1016                 1.1 Fixed listed permissions
1017                 1.0 Initial Version
1018
1019  New Version of this document can be viewed from http://cvs.jg555.com/viewcvs.cgi/lfs-hints