Changes between Version 5 and Version 6 of howto/SetupFetchmail


Ignore:
Timestamp:
Jun 4, 2008, 10:55:42 AM (16 years ago)
Author:
martin.osx@…
Comment:

disclaimer

Legend:

Unmodified
Added
Removed
Modified
  • howto/SetupFetchmail

    v5 v6  
    1616== Installation ==
    1717
    18 Install fetchmail with
     18First set-up a mail storage and a [wikipedia:Mail_transfer_agent mail transfer agent]  . See [wiki:howto/SetupDovecot Dovecot] and [wiki:howto/SetupPostfix Postfix] a possible set-up. Fetchmail will not work without and you can loose your mail if those components are not set-up properly.
     19
     20Then install fetchmail with
    1921
    2022{{{
     
    2628== Configuration ==
    2729
    28 === Step 1: '''TODO: Step 1 title''' ===
     30Note: Do not use any of the attached files without checking / changing them with your favourite text editor.
    2931
    30 TODO
     32=== Step 1: ''create user'' ===
     33
     34Fetchmail does not need root or normal iser privileges to run so it is suggested to create an unprivileged user and group for daemon based fetchmail configurations. You can use the [attachment:Make_Fetchmail_User.command] to do so.
     35
     36=== Step 2: ''create directories'' ===
     37
     38Dovecot need two directories to work with - one to store the run status, one for the log files. You can use the [attachment:Make_Fetchmail_Directories.command] to create the directories.
     39
     40Depending on which fetchmail (macports or OSX) is used you might want to change the pathnames to better reflect you system set-up.
     41
     42=== Step 3: ''set-up configuration'' ===
     43
     44Next you need to set up [attachment:fetchmailrc]. You find the file in {{{/opt/local/etc}}} (macports) or {{{/private/etc}}}. The file should be owned by _fetchmail:_fetchmail and only be readable to _fetchmail an no one else.
     45
     46As a starting point you can use [attachment:fetchmailrc]. You will need to add all your mail source to [attachment:fetchmailrc].
     47
     48=== Step 4: ''starting the daemon'' ===
     49
     50Fetchmail is started using {{{launchd}}} which is controlled by the attached [attachment:org.macports.fetchmail.plist].
     51
     52Depending on which fetchmail (macports or OSX) is used you might want to change the pathnames to better reflect you system setup.
     53
     54The attached [attachment:Restart_Fetchmail.command] command will stop and restart fetchmail which forces a re-read of the configuration files and triggers an immediate mail collection - quite helpful while debugging the system.
     55
     56=== Step 5: ''testing the deamon'' ===
     57
     58'''Before using fetchmail you should collect all your mail by conventional means.'''
     59
     60After starting fetchmail you should check if the start was succesfull by checking the syslog:
     61
     62{{{
     63$ syslog
     64
     65TODO: paste actual screen output.
     66}}}
     67
     68then you should check the two log files in {{{/opt/local/var/log/fetchmail}}}
     69
     70{{{
     71$ pushd "/opt/local/var/log/fetchmail"
     72
     73$ cat "..."
     74
     75TODO: paste actual screen output.
     76}}}
     77
     78Last you send yourself a mail and trigger a mail collection with [attachment:Restart_Fetchmail.command] and then check if the mail arrived ok in your local mail storage.
    3179
    3280== Optional Parts ==
    3381
    34 === '''TODO: What else can be done?''' ===
    35 
    3682[wiki:howto <- Back to the HOWTO section]