Page updated 1 November 2012
Introduction
Novice users can have difficulty figuring out what to type in each of the boxes of the Account Settings dialogue. A Setup file can ease their task, leaving them to enter as little as their own name, username and password.
This page is intended to assist those who wish to help support nPOPuk by providing Setup files for popular mail providers. Typically, these will be the major ISPs and webmail services in your country. If you use a well established ISP in your part of the world you are invited to submit a Setup file for that service provider via the Forum, from where they will be transferred to the Downloads page.
Many Internet Service Providers (ISPs) collect their settings into an "internet setup" file that they provide to customers. These will often customise far more than the mail client. nPOPuk can read the [Internet Mail] part of these files. The Downloads page includes some example files for common mail providers such as GMail and HotMail and you should examine them to see working versions of setup files. In particular you should note the method for calling for user input. Lines that take the form:
Setting=?{prompt}
generate a dialogue where the text "prompt" appears in the field to be entered by the user. It is also possible for lines to take the form:
Setting=?{prompt}text
In this case the text "text" will be appended to the value entered to replace "prompt" by the user and both parts will be assigned as the value of the setting.
There
is also one special case. When the "prompt" text is "password" a revised
version of the Setup File dialogue is presented to the user. This
replaces the "Enter value for:" text with "Enter password:" and any text
entered will be obscured with asterisks.
Settings
Standard .ins settings
The settings listed in this first section are commonly found in setup files, in the [Internet_Mail] section. Note that text values are always enclosed in quotes.
- Window_TITLE=
- Sets the account name that appears in the drop-down mailbox list or mailbox pane.
- POP_Server=
- The hostname of the POP3 server for incoming mail.
- SMTP_Server=
- The hostname of the SMTP server for outgoing mail.
- Email_Address=
- The e-mail address for the account.
- Email_Name=
- The plain-text name presented in the From: line of mail.
- Pop_Logon_Name=
- The username, which may be the same as the e-mail address.
- Pop_Logon_Password=
- The password. This value is NOT encrypted so completely insecure if entered in the file!
- Logon_Using_SPA=No
- Determines whether to use authentication when sending mail. (Alternate entry: Logon_Using_SPA=Yes)
Additional .ins settings
The settings in this next section match the style used above, but are not typically found in setup files from ISPs. (Since the server is set with POP_Server, one would expect POP_Port to set the port, but this has never been observed in an ISP's setup file. nPOPuk's own setting is named simply Port.)
- POP_SSL=0
- Determines whether SSL should be used for incoming mail. (Alternate
entry: POP_SSL=1)
Overridden by POPSSL - POP_Port=110
- The port number for the incoming mail server. Note the default is
995 if POP_SSL=1.
Overridden by Port - POP_RETR=Yes
- Determines whether to use the RETR command. NOTE: Some servers are
set also to delete mail when messages are retrieved. (Alternate entry:
POP_RETR=No).
Overridden by NoRETR - SMTP_SSL=0
- Determines whether SSL should be used for outgoing mail. (Alternate
entry: SMTP_SSL=1).
Overridden by SmtpSSL - SMTP_Port=25
- The port number for the outgoing mail server. NOTE: the default is
465 if SMTP_SSL=1.
Overridden by SmtpPort - SMTP_Auth=0
- Determines whether to use authentication for outgoing mail. NOTE:
The default is 1 if Logon_Using_SPA=Yes.
Overridden by SmtpAuth - SMTP_SSL_Type=0
- Selects the type of SSL connection:
0 = Automatic
1 = TLS 1.0
2 = SSL 3.0
3 = SSL 2.0
4 = STARTTLS
Overridden by SmtpSSLType
nPOPuk settings
The remaining settings use the strings found in nPOPuk's own configuration file and are documented within the Commented nPOPuk.ini file.
PopSSL=0
Port=110 (995 if PopSSL)
APOP=0
PopSSLType=0
PopSSLVerify=1
PopSSLDepth=-1
PopSSLCert=""
PopSSLPkey=""
PopSSLPass=""
NoRETR=0
NoUIDL=0
CyclicFlag=0
SmtpSSL=0
SmtpPort=25 (465 if SMTP_SSL)
PopBeforeSmtp=0
SmtpAuth=0
SmtpAuthType=0
AuthUserPass=0
SmtpSSLType=0
SmtpSSLVerify=1
SmtpSSLDepth=-1
SmtpSSLCert=""
SmtpSSLPkey=""
SmtpSSLPass=""