PSCS Wiki

Spam Filter Rules: ForEach

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: ForEach Statement ForEach Version 2.1.7+ Purpose Causes a loop to be run through for all values within specified criteria The ForEach statement requires either two or three parameters (depending on the type of loop that is being conducted), in the format

SMTP Server Lua Scripting

Anonymous (anonymous@undisclosed.example.com) — 2025-05-08T08:23:35+00:00

SMTP Server Lua Scripting The SMTP Server Lua Script is called SMTPSVR.LUA and can be edited from the Settings -> Scripts page in the VPOP3 settings. This script is called whenever an instance of the VPOP3 SMTP server is launched - ie whenever someone opens a connection to port 25 on the VPOP3 server to send it a message, whether from a local user or an incoming SMTP message.

Password Strength Checking Script

Anonymous (anonymous@undisclosed.example.com) — 2026-01-05T09:25:39+00:00

Password Strength Checking Script You can tell VPOP3 to enforce password strength checks by using a Lua script which performs the checks for you. The Lua script can be edited in Settings -> Scripts and is called passwordcheck.lua (in older versions of VPOP3 it is stored in a file called

Configure SRS

Anonymous (anonymous@undisclosed.example.com) — 2025-08-18T15:28:11+00:00

Configure SRS In VPOP3 8.8 and later, you can use Lua scripting to implement 'SRS' (Sender Rewriting Scheme') in VPOP3 This involves adding a couple of functions to rewrite outgoing return paths in 'relayout.lua' or 'mxout.lua' as appropriate and a couple of functions to redirect rewritten bounce message recipients in 'smtpsvr.lua'

Outgoing Message Scripting

Anonymous (anonymous@undisclosed.example.com) — 2024-03-21T10:49:54+00:00

Outgoing Message Scripting Every time VPOP3 adds a message to the Outgoing mail queue, it runs a script called outmessage.lua. Scripts are stored as files in the VPOP3 directory in VPOP3 v6.6 and earlier, or managed through the Settings -> Scripts page in VPOP3 v6.7 and later.

Lua SMTP Relay Control

Anonymous (anonymous@undisclosed.example.com) — 2025-08-14T09:24:55+00:00

Lua SMTP Relay Control Every time VPOP3 is going to send messages via SMTP Relay, it runs a script called relayout.lua in the VPOP3 directory. Global Variables This script may have global variables, depending on your version of VPOP3. In VPOP3 3.0.0L and later, there are two read-only global variables set at the start of the script:

Misc -> Advanced Tab

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Misc -> Advanced Tab Settings -> Misc Settings -> Advanced You will normally not need to change any settings on this page unless VPOP3 technical support have suggested it. If you do make changes, and want to go back to the original settings, the Restore Defaults button will restore the settings to their defaults.

Spam Filter Rules: IfMatch

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: IfMatch Statement IfMatch Version 2.1.7+ Purpose Allows you to perform a regular or substring match on a variable or part of the message being processed IfMatch statements require a data parameter and a search value, in the format

Batch file to end a database backup

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Batch file to end a database backup VPOP3 runs pg_dump.exe to perform the regular database backups. Ending this process through Task Manager will not end the back-end database processes creating the backup data. This batch file will do it for you.

Formatting Syntax

Anonymous (anonymous@undisclosed.example.com) — 2026-03-16T16:00:10+00:00

Formatting Syntax DokuWiki supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing

Repairing corrupted database

Anonymous (anonymous@undisclosed.example.com) — 2024-01-15T11:35:45+00:00

Repairing corrupted database With PostgreSQL (as with most high-end databases) the database system will automatically recover after power failures etc, if it can. If it can't then there is no manual 'repair' function, because the data cannot totally be recovered (or it would automatically have been recovered).

Group a user's folders into letter groups

Anonymous (anonymous@undisclosed.example.com) — 2026-03-16T11:12:42+00:00

Group a user's folders into letter groups This is useful in VPOP3 Enterprise if you have a large folder with many subfolders and want to group the subfolders into other subfolders based on their first letter For example, if you have * Customers

IMAP4 Server Scripting

Anonymous (anonymous@undisclosed.example.com) — 2025-06-23T10:51:46+00:00

IMAP4 Server Scripting (Added in V6.12) DoCapability function When the IMAP4 CAPABILITY command is received, VPOP3 generates a capability string based on settings, then calls DoCapability(ipaddr, capabilities) * ipaddr = IP address of the client computer

POP3 Client Lua Scripting

Anonymous (anonymous@undisclosed.example.com) — 2023-08-16T07:48:01+00:00

POP3 Client Lua Scripting The POP3 Client Lua Script is called POP3CLT.LUA and is edited in Settings -> Scripts. This script is called whenever VPOP3 runs a POP3 session to download messages from a remote POP3 server. VPOP3 will call the following Lua functions in the script at the following times:

Spam Filter Rules: BulkScan

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: BulkScan Statement BulkScan Version 2.1.7+ Purpose Allows you to specify lots of search strings in one section without needing the verbose If statement The BulkScan statement requires a variable name and a limitless number of search specifiers, in the format

Spam Filter Rules: If

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: If Statement If Version 2.1.7+ Purpose Enables you to perform a simple relational test on a variable You can specify a variable or a constant on either or both sides of the relational operator. The relational operator can be one of:

Spam Filter Rules: IfInBag

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: IfInBag Statement IfInBag Version 2.3.7+ Purpose Checks if a specified value is in a particular bag The IfInBag statement requires a bag name and value, in the format IfInBag * All IfInBag statements must be followed by an

Encryption

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Encryption There are several different encryption methods used on the Internet which are relevant to VPOP3. Current versions of VPOP3 Basic will be able to connect to other POP3 or SMTP servers using either SSL or TLS. This allows you to use VPOP3 to access services such as GMail which require SSL/TLS.

Can't alter dates in Autoresponder Rules

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Can't alter dates in Autoresponder Rules If you try to edit an Autoresponder Rule which has a start/end time set, you may notice that you can't edit the dates in there. This is because VPOP3 prevents you from setting it so that the “start date” is after the “end date

Settings -> Attachment Processing

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Settings -> Attachment Processing The Attachment Processing page allows you to configure VPOP3 to perform two distinct functions on messages that contain attachments: * * Filtering The Filtering tab is divided into four main sections: Attachment Filtering

Signature Script

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Signature Script If you want more complex signatures on outgoing emails, rather than the static text/HTML you can define within VPOP3, then you can use a simple Lua script to define the signature. The Lua script is stored in a file called signature.lua

Spam Filter Rules: Goto

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: Goto Statement Goto Version 2.1.7+ Purpose A mechanism for directing the script towards a specified label The Goto statement requires a label name, in the format Goto Labels are single word entries that appear on a line of their own, immediately preceded by the colon (:) character. The colon character is not part of the label name.

Spam Filter Rules: *IFSUPPORT

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: *IFSUPPORT Statement *IFSUPPORT Version 2.2.5+ Purpose Allows the script to determine whether a particular command or function is supported by the installed version of VPOP3 The *IFSUPPORT statement requires a command or a function, in the format

User Routing Script

Anonymous (anonymous@undisclosed.example.com) — 2023-03-27T10:32:18+00:00

User Routing Script If there is a /user_redirect.lua script, this Lua script can override VPOP3's message routing options. You can edit this either in the Settings -> Scripts page in the settings, or via the 'Routing' tab in the user's settings in the VPOP3 administration console. This script affects how VPOP3 will handle how messages

Calendar.Events table

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Calendar.Events table The Calendar.Events table contains a record of all the events in calendars managed by VPOP3. An 'event' is an iCalendar event. Note that if an event is a recurring series, there will only be one 'event' in the database, not one event per instance of the recurrence.

Lua SMTP MX Server Rules

Anonymous (anonymous@undisclosed.example.com) — 2026-02-24T15:50:03+00:00

Lua SMTP MX Server Rules Every time VPOP3 checks for remote MX server for sending messages using direct MX sending, it runs a script called mxserverrules.lua which can be created/edited in Settings -> Scripts (or in the VPOP3 directory in VPOP3 v6.6 or earlier).

Reset Message Folder Counts

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Reset Message Folder Counts In extremely rare cases, the mail folder message counts in the database may get out of step with the actual stored messages. There are database triggers which will keep the counts in sync during normal operation, but if you have to manipulate the database directly (eg to recover from a corrupted database) it is possible that they will get out of step.

Lua SMTP Rules Scripts

Anonymous (anonymous@undisclosed.example.com) — 2026-03-26T11:41:59+00:00

Lua SMTP Rules Scripts When VPOP3 is processing SMTP Rules for messages received by SMTP, it runs a script called smtprules_(x).lua, where (x) is replaced by the numeric ID of the SMTP service VPOP3 processes SMTP Rules at least three times for each message - once when MAIL FROM has been received, once for each RCPT TO, and once when the whole message data has been received.

Use the spam filter scripting to add random text to the subject on incoming messages

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Use the spam filter scripting to add random text to the subject on incoming messages This needs VPOP3 version 5 or later. This script is for the case where you want a message to the 'support' user to have the text [XXX-99999] added to an incoming message's subject if it does not already exist. Some people want this text to use as reference numbers for a

Increase the spam score for certain recipients

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Increase the spam score for certain recipients This script is for the case where you want certain recipients to have a weighted score. For instance if you have users who have left and who mostly receive spam, but you don't want to reject their mail totally.

Increase the spam score for header marker

Anonymous (anonymous@undisclosed.example.com) — 2020-10-05T16:14:12+00:00

Increase the spam score for header marker This script is for the case where your ISP adds a header eg 'X-Spam: Yes' to the message header, and you want the VPOP3 spamfilter to quarantine messages with that marker. Add the following to the spamrules_userchecks.txt file. This script file only gets processed on incoming messages (the spamrules_localmail.txt script ends the processing of locally sent messages)

Spamrules example - increase spam score for long sender domain

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spamrules example - increase spam score for long sender domain This script is for the case where you to increase the spamminess of emails where the sender's email address contains a long domain. In this case we'll say if the sender's domain has 20 or more characters in the first section (between the @ and first .). Note that we do not necessarily recommend that you do this as it is not a very good indicator of spam, but it is something we've been asked for, so here it is.

Spamrules example - increase spam score if there are many links in the email

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spamrules example - increase spam score if there are many links in the email This script is for the case where you to increase the spamminess of emails where the email contains many links - in this case we'll say if the email contains 10 or more links. Note that we do not necessarily recommend that you do this as it is not a very good indicator of spam, and will probably catch a lot of newsletter type emails, but it is something we've been asked for, so here it is.

Spam Filter Rules: ZipContents

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: ZipContents Statement ZipContents Version 6.7+ Purpose Enables the script to obtain the list of files contained in a ZIP attachment The ZipContents statement requires a message section number and bag name, in the format ZipContent

Spam Filter Rules: ZipContentsFull

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: ZipContentsFull Statement ZipContentsFull Version 6.7+ Purpose Enables the script to obtain the list of files contained in a ZIP attachment The ZipContentsFull statement requires a message section number and bag name, in the format

Spam Filter Rules: ZipCount

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: ZipCount Statement ZipCount Version 6.7+ Purpose Enables the script to obtain the number of files contained in a ZIP attachment The ZipCount statement requires a message section number and variable name, in the format ZipCount

Increase the spam score for subject marker

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Increase the spam score for subject marker This script is for the case where your ISP adds a marker eg '[spam]' to the message subject, and you want the VPOP3 spamfilter to quarantine messages with that marker. Add the following to the spamrules_userchecks.txt file. This script file only gets processed on incoming messages (the spamrules_localmail.txt script ends the processing of locally sent messages)

Status

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Status The VPOP3 Status screen has two tabs * Server Status * Sessions Server Status The Server Status tab is essentially a copy of the VPOP3 Status Monitor information. * Connection Status - this shows the 'online' status of VPOP3. If it says idle, it does not mean VPOP3 is not working, or not doing anything, it just means that it is not currently sending or collecting mail from the Internet.

User Manager Script

Anonymous (anonymous@undisclosed.example.com) — 2024-04-22T08:37:38+00:00

User Manager Script If you want people to be able to log in using a different username than their VPOP3 username (eg if you want them to be able to log in using an email address), then you can use the UserManager Lua script The Lua script is managed through the Settings → Scripts page in VPOP3 v8.0 and later and is called 'UserManager.LUA.

GDPR for VPOP3 self-hosted software

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

GDPR for VPOP3 self-hosted software VPOP3 is an email server program, it is not a service, so if you use VPOP3 on your own computer we are not a “data controller” or a “data processor” under GDPR rules as we never see any of your data (unless you give us permission to remotely connect to your PC for technical support purposes).

Multiple VPOP3 icons in the taskbar

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Multiple VPOP3 icons in the taskbar If you reinstall VPOP3 it is possible that you may end up with two VPOP3 Status Monitor icons in the task tray. This doesn't mean that two copies of VPOP3 are running, just that two copies of the VPOP3 Status Monitor are running.

How to Backup VPOP3

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

How to Backup VPOP3 By default VPOP3 v3 and later will automatically perform a daily backup of the database into a file called DBBACK-x.DMP, where the backup file rotates on a weekly basis (DBBACK-0.DMP is Sunday's backup, DBBACK-1.DMP is Monday's backup, etc).

How to create an SSL Certificate

Anonymous (anonymous@undisclosed.example.com) — 2026-03-23T10:18:43+00:00

How to create an SSL Certificate VPOP3 Enterprise supports SSL certificates for encrypted sessions. The basic mechanism to create an SSL certificate is that you have to generate a CSR (Certificate Signing Request) then send that to a CA (Certificate Authority) who will sign your certificate and give you the certificate back.

Database & Disk Caching

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Database & Disk Caching Disk Caching One key point is that, like all other high-end databases, PostgreSQL should not be run on a server with disk level write back caching. With write back caching, the disk will report data as being written to disk when it is still in the disk's cache memory. If the power then fails, this data is lost and can cause database corruption. As long as the database server really knows when the data has been written to disk, power failure will not cause database corru…

-ERR Can't open the message file - it's gone!

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

-ERR Can't open the message file - it's gone! If VPOP3 receives the error message “-ERR Can't open the message file - it's gone!” from your ISP's POP3 server when it is downloading messages, this is a symptom of a fundamental bug in your ISP's POP3 server.

How to filter attachments

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

How to filter attachments VPOP3 can filter attachments in several ways. The most general is to use the Settings -> Attachment Processing -> Filtering tab as described below. VPOP3 can also filter attachments using the content/spam filter, or by using an integrated virus scanner.

Timeout while VPOP3DB is starting

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Timeout while VPOP3DB is starting (Note that VPOP3 v6.11 and later, the service startup system has changed so it should not suffer from this problem) When VPOP3DB starts up, the service control manager component waits a set time for a response from the database server before it knows the service has started. If the PC is going slow (eg after a Windows update or if the PC is just slow) then this wait may not be long enough.

How to upgrade VPOP3 to version 7 or later from version 6 or earlier

Anonymous (anonymous@undisclosed.example.com) — 2020-06-29T10:43:58+00:00

How to upgrade VPOP3 to version 7 or later from version 6 or earlier As usual the process to upgrade is simply to install the later version over your existing installation (do not uninstall anything first). The below is technical information detailing an extra step performed by the installer in this particular upgrade step.

Move VPOP3 Version 3 or 4 to a new PC

Anonymous (anonymous@undisclosed.example.com) — 2019-11-12T16:09:08+00:00

Move VPOP3 Version 3 or 4 to a new PC Moving VPOP3 Version 3 or 4 to a new PC is slightly different from moving earlier versions, because of the database system. The summary of steps is: * Stop VPOP3 on the original PC * Manually make a backup of the database on the original PC

Move VPOP3 Version 5 (or later) to a new PC

Anonymous (anonymous@undisclosed.example.com) — 2026-04-21T11:12:40+00:00

Move VPOP3 Version 5 (or later) to a new PC Moving VPOP3 Version 5 or later to a new PC is slightly different from moving earlier versions, because of the database system, which was introduced for version 3 and modified for version 5. The summary of steps is: * Stop VPOP3 on the original PC

VPOP3 Not Starting Properly

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

VPOP3 Not Starting Properly If VPOP3 is not starting properly, then the first thing to check is whether the database server is starting. In VPOP3 v3 and later, VPOP3 uses a PostgreSQL Database server for data storage, so if the database server is not running, VPOP3 will not be able to start properly. In this case, the VPOP3.EXE process may appear in Task Manager, but it won't respond to anything, or it may appear in Task Manager and then stop after a short period.

How to write your own spam filter rules

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

How to write your own spam filter rules VPOP3's spam filter uses a basic scripting language designed for filtering email messages, so a full description of writing your own rules would be very long and complex, as it is really something that only a programmer should do.

Archive Script

Anonymous (anonymous@undisclosed.example.com) — 2023-03-25T23:33:31+00:00

Archive Script (from VPOP3 v6 onwards) Archive scripting lets you indicate whether full message content should be stored in the message archive. This could be used, for instance, for filtering out messages containing credit card details. The message headers will still be archived, along with the explanation text returned by the script.

Autoresponder scripting

Anonymous (anonymous@undisclosed.example.com) — 2025-05-28T09:24:38+00:00

Autoresponder scripting For scripting to alter the whole autoresponder definition and set in the VPOP3 settings rather than embedded in an autoresponder itself, see Autoresponder Global Scripting In an autoresponder, you can create a Lua script by surrounding it with & tags, eg

Copy SMTP Rules - Database Query

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Copy SMTP Rules - Database Query This is an advanced Database action. There is no simple query that will perform the required operation, so we have to create a custom PostgreSQL function to copy the data. At a command prompt in the VPOP3 directory run

Lua SMTP MX Control

Anonymous (anonymous@undisclosed.example.com) — 2026-02-24T15:49:48+00:00

Lua SMTP MX Control Every time VPOP3 is going to send messages using direct MX sending, it runs a script called mxout.lua which can be created/edited in Settings -> Scripts (or in the VPOP3 directory in VPOP3 v6.6 or earlier). Global Variables Starting with v8.8, the following global variables are defined:

SMTP Direct Sender Settings

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

SMTP Direct Sender Settings Mail Connectors -> Mail Senders -> SMTP Direct Sender -> Settings tab The SMTP Direct Settings tab lets you set how VPOP3 will send mail using SMTP Direct DNS Servers to Use This setting tells VPOP3 the IP addresses of the DNS servers it should use to find the recipients' mail servers. Separate multiple addresses with commas.

Use the spam filter scripting to add fixed text to the subject on incoming messages

Anonymous (anonymous@undisclosed.example.com) — 2021-12-13T15:20:04+00:00

Use the spam filter scripting to add fixed text to the subject on incoming messages This needs VPOP3 version 5 or later. This script allows you to add fixed text to the subject an incoming message, eg so that users can see that a message is an incoming rather than local message (be aware of weaknesses in this strategy - eg forwarded messages, spoofing of the marker, breaking DKIM message signatures, etc)

Spam Filter Rules: AddHeader

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: AddHeader Statement AddHeader Version 2.1.7+ Purpose Allows you to add, replace or remove the specified header line in the message headers The AddHeader statement requires the full header line in one continuous string, in the format

Spam Filter Rules: Break

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: Break Statement Break Version 2.1.11+ Purpose Breaks out of a loop prematurely Example ForEach Recipient Rcpt IfMatch ${Rcpt} "/@spammer.com/i" ${Score} += 100 Break EndIf EndFor

Spam Filter Rules: GetDecodedSection

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: GetDecodedSection Statement GetDecodedSection Version 2.1.11+ Purpose Returns a specified MIME section of a message into a variable, after processing any Base64 or Quoted-Printable encoding of the raw message data The GetDecodedSection

Spam Filter Rules: GetSectionEncoding

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: GetSectionEncoding Statement GetSectionEncoding Version 2.3.9+ Purpose Retrieves the MIME encoding method for the specified MIME section number, and returns the result into the specified variable The GetSectionEncoding statement requires a message section number and variable name, in the format

Spam Filter Rules: GetSectionMD5

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: GetSectionMD5 Statement GetSectionMD5 Version 2.3.6+ Purpose Performs an MD5 hash on a specified MIME section of the message, and returns the result into the specified variable in hex encoded form The GetSectionMD5 statement requires a message section number and variable name, in the format

Spam Filter Rules: IfLocalAddress

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: IfLocalAddress Statement IfLocalAddress Version 2.2.1+ Purpose Allows you to check if a specified email address is local to your VPOP3 installation IfLocalAddress requires just one paramater; the address, in the format IfLocalAddress

Virus Scan Filter Scripting

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Virus Scan Filter Scripting (Added in V6.17) The VIRUSSCAN.LUA script has a single function FilterResult This function is called for every virus that a VPOP3-integrated (eg VPOP3 AV or Sophos SAV Interface) detects. The function has the opportunity to 'filter' the virus detection so that VPOP3 will act as if the virus was not detected.

SMTPClientAllows Replacement

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

SMTPClientAllows Replacement Use: ~smtpclientallows~ ~end~ The format string can have the replacements * address - IP address (returned as host address or CIDR address as appropriate) * date - the date/time the address was added to the database in YYYYMMDDHHMMSS format

SMTPClientBlocks Replacement

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

SMTPClientBlocks Replacement Use: ~smtpclientblocks~ ~end~ The format string can have the replacements * address - IP address (returned as host address or CIDR address as appropriate) * date - the date/time the address was added to the database in YYYYMMDDHHMMSS format

SMTPSPFWhitelist Replacement

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

SMTPSPFWhitelist Replacement Use: ~smtpspfwhitelist~ ~end~ If you specify the parameter serverid then this will just return white list entries which match all servers or this server. The format string can have the replacements * id - the whitelist entry ID

UserRuleActions Replacement

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

UserRuleActions Replacement Use: ~userruleactions~ ~end~ Required parameter: Account, RuleId This returns the message rule actions for the specified rule The format string can have the replacements * id - numeric ID of the action * type - action type

UserRuleConditions Replacement

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

UserRuleConditions Replacement Use: ~userruleconditions~ ~end~ Required parameter: Account, RuleId This returns the message rule conditions for the specified rule The format string can have the replacements * id - numeric ID of the condition

UserRuleList Replacement

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

UserRuleList Replacement Use: ~userrulelist~ ~end~ Required parameter: Account This returns the message rule list (in order) for the specified user The format string can have the replacements * id - numeric ID of the rule * order - numeric order number (1-n) of the rule

Support Remote Access facility

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Support Remote Access facility If you use a paid technical support option we have the facility to remotely access your VPOP3 server if you wish. This allows us to help you resolve issues or assist with configuration or installation issues. You can either allow us to just view your screen and tell you what to do, or you can allow us to control your computer as well.

What is the VPOP3 Antivirus solution?

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

What is the VPOP3 Antivirus solution? “VPOP3 Antivirus” is a new product to replace the avast! for VPOP3 product which will no longer be supported after the end of 2012. VPOP3 Antivirus uses the popular 'ClamAV' virus scanner to scan incoming and outgoing messages for viruses.

Socket Error 10054 - The virtual circuit was reset by the remote end

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Socket Error 10054 - The virtual circuit was reset by the remote end Error 10054 means that the connection between VPOP3 and a remote computer (eg the ISP or another computer on your LAN) was disconnected by something outside of VPOP3. This is often caused by anti-virus software or Internet security/firewall on the VPOP3 machine but it could be any of a number of things. Any software or hardware that is sitting between VPOP3 and the ISP could be the root cause.

How To Allow Mail Relay Through VPOP3

Anonymous (anonymous@undisclosed.example.com) — 2025-05-21T07:57:18+00:00

How To Allow Mail Relay Through VPOP3 If you are allowing remote access into VPOP3 to collect mail then you may also want those remote users to be able to send their outgoing mail through VPOP3 as well. This is more complex than allowing users to collect mail, because, by default, SMTP connections are not authenticated. This means that when someone tries to send a message through VPOP3, VPOP3 doesn't know who that user is. This can cause a problem if unauthorised users try to send mail through…

Attachments have been removed or renamed

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Attachments have been removed or renamed If you have received an email and one or more of its attachments have been removed or renamed, it might be a result of Attachment Filtering. You can inspect the filtering rules by going to Administration Settings -> Settings ->

Autoresponders / Out of Office

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Autoresponders / Out of Office VPOP3 has an autoresponder facility for sending automatic replies when a message arrives in a mailbox. This is often used for 'Out of Office' replies, but it is not limited to that use. To set an autoresponder, the administrator can edit the user and go to the

Controlling VPOP3 via Email

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Controlling VPOP3 via Email You can control certain aspects of VPOP3 by sending emails to 'mailer_daemon@' The subject line must be one of the lines below: * Set Assistant * Query Assistant * Password * Set Forwarding * Query Forwarding

How to send a fax by email using the VPOP3 FaxServer

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

How to send a fax by email using the VPOP3 FaxServer VPOP3 2.1.0 and later together with the VPOP3 FaxServer software allows you to send specially crafted emails to VPOP3 to have them sent as faxes. To do this, send an email to fax@ . The email subject will be the subject of the fax used on the fax cover page. The email should be in plain text (not

Error expanding recipient - Nesting Level too deep

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Error expanding recipient - Nesting Level too deep You receive an error message saying: Error expanding recipient "" Nesting Level too deep (51) Check the configuration for loops (Note the '51' number may be slightly different - that's the nesting level - anything over 50 is detected as an error)

Forwarded Emails Not Arriving

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Forwarded Emails Not Arriving If you are having problems having VPOP3 forward incoming messages to an external address, but sending messages directly to that address works OK, and forwarding internal messages to that address works OK, then the problem may be the SMTP return address which VPOP3 is using.

Configuring iCal on Mac OSX to connect to VPOP3's CalDAV service

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Configuring iCal on Mac OSX to connect to VPOP3's CalDAV service This requires VPOP3 v6 or later. The following instructions are for Mac OS X v10.7.5 but should work with similar versions. We have not been able to create an account by going to System Preferences

How to Install VPOP3

Anonymous (anonymous@undisclosed.example.com) — 2021-03-08T10:48:40+00:00

How to Install VPOP3 Simply download VPOP3 from the website, and run the installation program and follow the prompts. Occasionally people may have problems with the PostgreSQL part of the installation. If that happens, please contact us either by email at support@pscs.co.uk or by phone to +44 (0)1484 855800, and we will do our best to help.

Seeing where a message came from

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Seeing where a message came from Sometimes you need to check to see where a message really came from. The 'From:' email address is easily forged, so that cannot be relied upon. The first thing you have to do is to get the full message headers. These may look daunting, but are very useful for problem diagnosis.

Signing outgoing mail with DKIM

Anonymous (anonymous@undisclosed.example.com) — 2020-07-22T10:32:40+00:00

Signing outgoing mail with DKIM DKIM, also known as DomainKeys Identified Mail, is a form of email authentication that digitally signs emails to prove that they were sent from authorized domains and aren't fake emails. Companies like Google and Yahoo use DKIM to sign their emails and it is becoming ever more popular.

Status Monitor is open during installation

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Status Monitor is open during installation During installation, if the installer says that the VPOP3 Status Monitor is open, and won't let you install VPOP3, that means that Windows is refusing to let the installer overwrite the VPOP3STATUS.EXE program. Usually that means that it is currently running.

The message could not be loaded. Please return to the Quarantine page and try again

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

The message could not be loaded. Please return to the Quarantine page and try again This error normally means the message file has been deleted from the hard disk (probably by a virus scanner or something else on the PC). If you can find the message in the VPOP3 settings (Settings

How To Upgrade VPOP3

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

How To Upgrade VPOP3 Note: if you are upgrading to VPOP3 version 5 or later from version 4 or earlier, please see How To Upgrade VPOP3 to version 5 Upgrading VPOP3 is a straightforward process. Download VPOP3 from our web site and ideally back up your current installation just in case something goes wrong. Then simply run the installer that you downloaded and install it over the top of your existing VPOP3. All your settings and mail will be preserved.

Upgrading VPOP3 to version 8.x from v7 or earlier

Anonymous (anonymous@undisclosed.example.com) — 2020-09-03T15:07:34+00:00

Upgrading VPOP3 to version 8.x from v7 or earlier VPOP3 v8.x uses PostgreSQL 10 as its database engine, which is the latest supported 32 bit version of PostgreSQL. Later versions of PostgreSQL are 64-bit only, which means we cannot use them while continuing to support 32 bit versions of Windows.

Upgrading VPOP3 to version 9.x from v7 or v8

Anonymous (anonymous@undisclosed.example.com) — 2026-03-18T20:49:54+00:00

Upgrading VPOP3 to version 9.x from v7 or v8 VPOP3 v9 and later requires a 64 bit version of Windows 8.1 or later VPOP3 v9.x uses PostgreSQL 18 as its database engine. This can only easily be upgraded from PostgreSQL 9.3 or later, which means it must be an upgrade of VPOP3 v7 or later. If you are using an earlier version of VPOP3, then upgrade it to v8.7 first, then upgrade to v9 or later

VPOP3 Antivirus Update Error - Error 11

Anonymous (anonymous@undisclosed.example.com) — 2025-10-06T15:24:19+00:00

VPOP3 Antivirus Update Error - Error 11 If you receive an “Error 11” when VPOP3 Antivirus is attempting to upgrade, then this means that it cannot download the antivirus updates from the Internet * Make sure you are using the latest version of the VPOP3AV plugin. You can check the version in the Settings

UserRuleActions Replacement

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

UserRuleActions Replacement Use: ~userruleactions~ ~end~ Required parameter: RuleId This returns the message rule actions for the specified rule The format string can have the replacements * id - numeric ID of the action * type - action type

UserRuleConditions Replacement

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

UserRuleConditions Replacement Use: ~userruleconditions~ ~end~ Required parameter: RuleId This returns the message rule conditions for the specified rule The format string can have the replacements * id - numeric ID of the condition * field - field/data to test

UserRuleList Replacement

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

UserRuleList Replacement Use: ~userrulelist~ ~end~ Required parameter: None This returns the message rule list (in order) for the current user The format string can have the replacements * id - numeric ID of the rule * order - numeric order number (1-n) of the rule

Attachment Extraction Scripting

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Attachment Extraction Scripting This is the 'extraction.lua' script. (Added in V6.17) This script has one functions: * Extract This functions is called if the attachment extraction is enabled in Settings -> Attachment Processing -> Extraction.

Settings -> Database

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Settings -> Database The Settings -> Database page lets you configure the use of the back-end database which VPOP3 uses for configuration data, message storage and other uses. Tabs * Backups * Query * Connection * Message Store * Restore

DMARC Reporter Script

Anonymous (anonymous@undisclosed.example.com) — 2023-11-12T09:51:40+00:00

DMARC Reporter Script (from VPOP3 v8.6 onwards) This script lets you customise how VPOP3 sends DMARC reports to the sending domain. This can be useful in case the sending domain's DMARC configuration is incorrect as that can cause errors sending the reports or cause messages to be 'stuck' in VPOP3's Outqueue. These problems won't cause any lasting damage, but may be inconvenient or annoying, so you can alter the behaviour using Lua scripting

Error Handling Scripting

Anonymous (anonymous@undisclosed.example.com) — 2023-11-20T10:18:01+00:00

Error Handling Scripting For most error messages that VPOP3 generates, it allows control of error messages, eg to limit the frequency of error messages if they would be generated repeatedly. These limits are set in Settings -> Admin Settings -> Message Control. However, if you want more granular control, you can use Lua scripting for more fine-grained control

Mail Connectors -> Mail Senders

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Mail Connectors -> Mail Senders The Mail Sender tells VPOP3 how to send mail out to the Internet. If you want to send mail for specific users to another specific mail server (e.g. a local Microsoft Exchange Server or another VPOP3 server) then use the

Management Scripting

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Management Scripting In VPOP3 Enterprise, from version 6.17 there is the facility to run Lua scripts manually or according to a schedule. These scripts can do things like access mail folders & messages and perform some maintenance on them. Creating a new script

msgaudit Database table

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

msgaudit Database table This can (optionally) contain data showing how messages have been handled (eg deleted, moved, etc) * id - incrementing ID of msgaudit entry * datetime - the date & time the event occurred * component - which VPOP3 component performed the event

Send Admin Message

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Send Admin Message It is possible for administrator users to send a bulk email message to an entire group or list. To begin composing an email, go to the Administration Settings -> Users page, and click Send Admin Message. This should then open a window, which allows you to specify various options.

Mail Connectors -> Mail Senders -> SMTP Direct

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Mail Connectors -> Mail Senders -> SMTP Direct VPOP3 can be configured to send mail directly to the recipient's mail server (or the recipient's mail service provider). Usually this is only used if you have a high-end business class Internet connection - such as a leased line, or your mail server is co-located in a data centre. Attempts to use SMTP Direct sending on a dial-up/ADSL/Cable/FTTC/etc connection may be problematic since the receiving mail server may think you a home user who has been …

SMTP Server -> Spam Reduction

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

SMTP Server -> Spam Reduction The Spam Reduction tab lets you configure various ways VPOP3 can reduce spam and email address spoofing Domainkeys “Domainkeys” is a way of signing a message to show that it comes from the person it claims to come from. The system is too complex to go into here, but it essentially takes key parts of the message header, as well as the message body and creates a PKI digital signature on it, using a 'private key' on your system. The receiving end will find the same…

Spamfilter Script Configuration tab

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spamfilter Script Configuration tab You reach this tab by going to Settings --> Spam Filter -> General, and then choose the General tab. The Spamfilter script has various settings that can be changed to alter the behaviour of the spamfilter. These are defined in the script, so may change with different versions of the script. The settings are currently:

Spam Filter Rules: Comments

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: Comments In the spam filter scripts, blank lines are ignored. Any line beginning with a # character is treated as a comment. Comments must be on a line of their own; there is no way to add a comment to the end of a line. Examples

Allow messages through from a specific IP address

Anonymous (anonymous@undisclosed.example.com) — 2022-01-25T11:59:27+00:00

Allow messages through from a specific IP address This script allows messages through the spam filter if they arrive at VPOP3 from a specific SMTP sender (only when the message is sent directly to VPOP3 using SMTP, not via another server). Add the following to the spamrules_userlocal.txt file. This script file gets processed on all messages.

Spam Filter Rules: AddBayesHam

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: AddBayesHam Statement AddBayesHam Version 2.1.7+ Purpose Adds the current message to the 'not-spam' (or 'ham') Bayesian database Example Add the message to the 'not-spam' database if score is less than 100 If ${Score} < 100 AddBayesHam EndIf

Spam Filter Rules: AddBayesSpam

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: AddBayesSpam Statement AddBayesSpam Version 2.1.7+ Purpose Adds the current message to the 'spam' Bayesian database Example Add the message to the 'spam' database if score is 100 or more If ${Score} >= 100 AddBayesSpam EndIf

Spam Filter Rules: DNSBL

Anonymous (anonymous@undisclosed.example.com) — 2020-10-23T16:07:49+00:00

Spam Filter Rules: DNSBL Statement DNSBL Version 2.1.7+ Purpose Allows the script to perform a DNS blacklist lookup, returning the result into a specified variable The DNSBL statement requires a hostname, DNSBL zone and variable name, in the format

Spam Filter Rules: RemoveBayesHam

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: RemoveBayesHam Statement RemoveBayesHam Version 2.1.7+ Purpose Removes the current message from the 'not-spam' (or 'ham') Bayesian database Example Remove the message from the 'not-spam' database if score is 100 or more If ${Score} >= 100 RemoveBayesHam EndIf

Spam Filter Rules: RemoveBayesSpam

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spam Filter Rules: RemoveBayesSpam Statement RemoveBayesSpam Version 2.1.7+ Purpose Removes the current message from the 'spam' Bayesian database Example Remove the message from the 'spam' database if score is less than 100 If ${Score} < 100 RemoveBayesSpam EndIf

Status Monitor (port 5109) protocol

Anonymous (anonymous@undisclosed.example.com) — 2019-08-19T08:58:45+00:00

Status Monitor (port 5109) protocol This page documents the protocol used between VPOP3 and the Status Monitor. It's not intended for any other purpose, so it's a bit limited, but in certain cases you may find this useful Login Before the Status Monitor receives any updates or can issue commands it must log in using a user's credentials.

Useful other things

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Useful other things Scripts/batch files/etc which may be useful * batch file to end a database backup

VPOP3.GetMessageLines

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

VPOP3.GetMessageLines The Lua function 'VPOP3.GetMessageLines' retrieves content lines from the message currently being processed This function is only available in the ProcessMessage function of the POP3CLT.LUA or SMTPSVR.LUA scripts. It takes one parameter: * number - number of lines to retrieve

VPOP3.MessageSeek

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

VPOP3.MessageSeek The Lua function 'VPOP3.MessageSeek' sets an internal read pointer to the specified location of the message being processed This function is only available in the ProcessMessage function of the POP3CLT.LUA or SMTPSVR.LUA scripts. It takes one parameter:

Spamfilter White/Blacklists

Anonymous (anonymous@undisclosed.example.com) — 2018-11-14T10:45:49+00:00

Spamfilter White/Blacklists This lets you set whitelists & blacklists for the spam filter. There are four lists you can manage. The Whitelist Addresses & Blacklist Addresses lists let you specify sender email addresses to check. With the default rule weights, if a sender's address is on the Whitelist, it will be allowed through the spam filter, and if it is on the Blacklist it will be blocked. If an address is on both the Whitelist and the Blacklist, they will cancel each other out, and the me…