POPFile Documentation |

First Time Setup: |  | Step 1 Installing |  | Step 2 Bucket Setup |  | Step 3 Email Programs |  | Step 4 Training |

Using POPFile with: |  | Firewalls |  | Secure Password Authentication |  | Other Proxies |  | Multiple Email Accounts

## Getting Your Email Program To Talk To POPFile

POPFile works as a proxy server. Your email program talks to POPFile, which talks to your email server on its behalf. Instead of your email program getting messages directly, POPFile grabs them first, and scans them to decide what bucket they should go into.

Once it's decided - which takes only a fraction of a second - POPFile does one of two things: it can add a tag like [this] to the start of the subject line; which means that simple filtering programs like Microsoft Outlook Express can deliver your mail where it's supposed to - or, for more advanced email programs like Eudora, it can add a new email header like this:

X-Text-Classification: personal

- which your email program can use as a filter.

However, you need to do two things to get your email program talking to POPFile:

1. Adjust your email program's settings to make it talk to POPFile, and
2. set up your email filters so that things get filed properly.

Let's adjust the mail settings first. We'll set up filters in a moment.

Below are instructions for some of the more popular email programs. For others - or for advanced users - here are the general instructions:

- Change the POP3 server name in your email client to 127.0.0.1, noting the original address.
- Change the POP3 user name to [original-POP3-server-address]:[username]
- Leave the password alone

For accounts using Secure Password Authentication, see Using POPFile with: Secure Password Authentication.

Just choose your email program and follow the column down. While these instructions might look complicated, they actually only take about two minutes - and it's hard to go wrong. (Just in case, make a note of your original settings in case you need to go back.)

### Outlook

- In Outlook select the Tools->Email Accounts... menu option. The E-mail Accounts dialog will appear. [screenshot]
- Click View or change existing e-mail accounts and click Next. Choose the account you want to use POPFile with and click Change... Make a note of the Incoming mail server (POP3) server name and the User Name. [screenshot]
- Change the Incoming mail server (POP3) server name to 127.0.0.1 and change the User Name to the combination of the original Incoming mail server (POP3) server name and the original User Name separated by a colon. [screenshot]
- So, if the original Incoming mail server (POP3) name was my.mail.com and your username was jdoe, your new username would be my.mail.com:jdoe
- You don't need to change the password.
- Hit Next and then Finish.
- Ensure that POPFile is running and all mail will be delivered through POPFile!
- You'll need to make sure POPFile starts whenever Windows does. If you're using the Windows installer version, you can drag the 'Start POPFile in Background' link from the POPFile group in the Start menu to the Startup group. Now, Windows will load POPFile each time.
- Important! If POPFile isn't loaded, the mail will not get through - and your email program won't connect!

### Outlook Express

- In Outlook Express select the Tools->Accounts... menu option. The Internet Accounts dialog will appear. [screenshot]
- Select the account you wish to modify to use POPFile and click on Properties. [screenshot]
- Choose the Servers tab. Make a note of the Incoming Mail (POP3) server name and the Incoming Mail Server Account Name. [screenshot]
- Change the Incoming Mail (POP3) server name to 127.0.0.1 and change the Incoming Mail Server Account Name to the combination of the original Incoming Mail (POP3) server name and the original Incoming Mail Server Account Name separated by a colon. [screenshot]
- So, if the original Incoming Mail server name was my.mail.com and your username was jdoe, your new username would be my.mail.com:jdoe
- You don't need to change the password.
- Hit OK and then Close.
- Ensure that POPFile is running and all mail will be delivered through POPFile!
- You'll need to make sure POPFile starts whenever Windows does. If you're using the Windows installer version, you can drag the 'Start POPFile in Background' link from the POPFile group in the Start menu to the Startup group. Now, Windows will load POPFile each time.
- Important! If POPFile isn't loaded, the mail will not get through - and your email program won't connect!

### Eudora

- In Eudora select the Tools->Options... menu option. The Options dialog will appear. [screenshot]
- Make a note of the Mail Server (incoming) server name and the Login Name. [screenshot]
- Change the Mail Server (incoming) server name to 127.0.0.1 and change the Login Name to the combination of the original Mail Server (incoming) server name and the original Login Name separated by a colon. [screenshot]
- So, if the original Mail Server (incoming) server name was my.mail.com and your username was jdoe, your new username would be my.mail.com:jdoe
- You don't need to change the password.
- Hit OK.
- Ensure that POPFile is running and all mail will be delivered through POPFile.
- You'll need to make sure POPFile starts whenever Windows does. If you're using the Windows installer version, you can drag the 'Start POPFile in Background' link from the POPFile group in the Start menu to the Startup group. Now, Windows will load POPFile each time.
- Important! If POPFile isn't loaded, the mail will not get through - and your email program won't connect!

### Pegasus

- In Pegasus select the Tools->Internet Options... Receiving (POP3) tab. The POP3 account setup page will appear.
- Under General settings for receiving mail using POP3, select the POP3 Host dialog box. Make a note of the current POP3 host.
- Change the POP3 Host to 127.0.0.1
- Under General settings for receiving mail using POP3, select the User name dialog box. Make a note of the current User name.
- Change the User name to the combination of the original POP3 Host name and the original User name separated by a colon.
- So, if the original POP3 host was my.mail.com and your User name was jdoe, your new User name would be my.mail.com:jdoe
- You don't need to change the password.
- Click the OK Button to save the changes.
- Ensure that POPFile is running and all mail will be delivered through POPFile!
- You'll need to make sure POPFile starts whenever Windows does. If you're using the Windows installer version of POPFile, you can drag the 'Start POPFile in Background' link from the POPFile group in the Start menu to the Start -> Programs -> Startup group. Now, Windows will load POPFile each time.

Okay. Now we've done that, it's time to set up your mail filters, so that once POPFile has done its work, your email program can take that and put everything in the right folder.

For advanced users, you have the option to modify the subject line to add a [classification] tag or not. It's near the bottom of the Configuration tab in the web UI. No matter which option you choose, the X-Text-Classification header is still added.

Just choose your email program and follow the column down. While these instructions might look complicated, they actually only take about two minutes - and it's hard to go wrong. (Just in case, make a note of your original settings in case you need to go back.)

### Outlook

- In Outlook select the Tools->Rules Wizard... [screenshot]
- The Rules Wizard appears. Click New... and select Start from a blank rule. [screenshot]
- Outlook can use the X-Text-Classification header, which allows mail filtering to occur completely in the background. Click Next and select with specific words in the message header.
- Now click the grey highlighted specific words link and enter "X-Text-Classification: " followed by the name of one of your buckets in the box that appears and hit Add, then OK.
- Click Next and select move it to the specified folder.
- Click the grey highlighted word specified and a list of folders appears. Select whichever folder you want to move messages from that bucket to and hit OK.
- Hit OK, then Finish.
- Repeat the process for each of your buckets, then OK out.
- You're done!
- One minor note: in the POPFile web interface, under the Configuration tab, check that the Subject Line Modification option is turned off.

### Outlook Express

- In Outlook Express select the Tools->Message Rules->Mail... [screenshot]
- The New Mail Rule window appears. [screenshot]
- Outlook Express cannot use the X-Text-Classification header, which would allow mail filtering to occur completely in the background. So instead, click Where the Subject line contains specific words and also click Move it to the specified folder [screenshot]
- Now click the blue highlighted contains specific words link and the Type Specific Words dialog appears [screenshot]
- Enter the name of one of your buckets, surrounded by [square brackets], then hit OK. Now click the blue highlighted specified word and the Move dialog appears. Click the folder you want to move messages from that bucket to and hit OK. [screenshot]
- Hit OK.
- Repeat the process for each of your buckets, and then OK out.
- You're done!
- One minor note: in the POPFile web interface, under the Configuration tab, check that the Subject Line Modification option is turned on.

### Eudora

Eudora allows filtering based on any mail header, which is great - everything can be done completely in the background, without changing the subject line!

- Select the Tools->Filters menu. [screenshot]
- The Filters window appears. Click New to create a new filter. [screenshot]
- In the Header box type X-Text-Classification and in the box next to contains type the name of one of your buckets. Don't add square brackets around it. [screenshot]
- The select Transfer To in the first Action box and select the mailbox you want to file message from this bucket into. [screenshot]
- Repeat this for each of your buckets.
- Close the Filters windows and say Yes when asked to save changes.
- You're done!
- One minor note: in the POPFile web interface, under the Configuration tab, check that the Subject Line Modification option is turned off.

### Pegasus

- In Pegasus select the Tools->Mail Filtering Rules ->Edit New Mail Filtering Rules ->Rules Applied When Folder is Opened.
- The New Mail Filtering Rules window appears.
- Click the New Rule button. The Create a New Filtering Rule window appears.
- Click on the Expression button. Note that using the Expression filter will work even if the POPFile Subject Line Modification option is turned off. If you use the Header filter, the POPFile Subject Line Modification option must be turned on.
- Select the If this regular expression dialog box
- Enter the name of one of your buckets, preceded X-Text-Classification:, for example: X-Text-Classification: spam
- Select the Headers or body radio button
- Select the desired action from the Action drop down list. For example Move
- If an action such as Move or Forward has been chosen, click the Set button.
- Select the destination folder or enter the forward to address as appropriate for the Action selected.
- Click the OK button to add the rule to the rule list.
- Repeat the process for each rule you need.
- The order in which the filter rules are applied can be adjusted using the red / blue (up / down) arrows in the New Mail Filter Rules window.
- Select the Save button to save the rules set changes.
- Select the OK button.
- You're done!

## That's all there it to it!... but...

Despite all this, POPFile still won't filter mail right now. Why not? It doesn't know what any of the buckets you entered mean. It has no idea what 'spam' and 'genuine' mean, or what 'work' and 'personal' are. It doesn't even know what language your e-mail is in - and it doesn't care. You need to train it to distinguish spam from regular email, or one project from another. You do this through training - and we'll deal with that next.

Web Links: |  | Home Page |  | Forums |  | Bug Database |