Developers Tools

  • Increase font size
  • Default font size
  • Decrease font size
Home SMTP Control User Guide

SMTP Control User Guide 0.5.0

Print PDF

Using SMTP Control 0.5.0

By default, when SMTP Control is installed for the first time, the SMTP Control Swap feature is enabled. The SMTP Control Filtering feature is disabled for all the mail accounts. Which mean that each mail account has access to all the defined SMTP servers.

To use dynamic SMTP server to send a mail message, you just have to select the requested SMTP server from the drop-down menu that was added right to the "Send" button by SMTP Control.

In the picture above, you can see that :

  • the default SMTP server for the current location is "SMTP OVH SSL"
  • the default SMTP server for the "From:" email account is "SMTP OVH"
  • the user decide to use the "" SMTP server for sending this email.

The listed SMTP servers are the available servers for the sending mail account ("From:" in the compose window). If you have configured SMTP filtering for the mail account only allowed SMTP servers for thise mail account are proposed. If you change the sending account ("From:"), other SMTP servers might be proposed.
Following the SMTP Server name you can see in brackets :

  • (account default) : Indicates the SMTP server statically defined for this email account,
  • (default for this location) : Indicates the SMTP server defined for this location,
  • (global default) : Indicates the SMTP server defined as default in thunderbird when no static configuration is made for the email account

In any case, when sending a mail message by the legacy "Send" button, or through the dynamic SMTP feature, SMTP Control will check if the SMTP server is in the allowed list for this email account. If not, an alert popup will warn you, and the email will not be send.

You can also, optionaly, asked for a confirmation, each time you select a dynamic SMTP server. This allow you to double-check your choice and decide if you want to really use a specific server or not.

SMTP Control Settings


SMTP Control settings can be accessed by the option button in the Add-ons manager, or by selection "SMTP Control Settings ..." in the "Tools -> SMTP Control" popupmenu from the main thunderbird window, or from the compose message window.

SMTP Filtering

With SMTP Filtering you can select which SMTP server can be used per email account defined in thunderbird. Because SMTP servers are defined globally, enabling SMTP Swap will enable all SMTP servers for all accounts by default. SMTP Filtering allows for customization of supported SMTP servers.

SMTP Location

SMTP Location allows you to define different locations (Home, Office, Customer-office, ...) and associate a default SMTP server per location.

SMTP Control will use network properties to find the location. The following properties will be used :

  • Local IP (Internet Protocol) address of your device,
  • Remote IP address of your device. It can be the same as the local one, or a different one, for example if your network is protected behind a router with a NAT (Network Address Translation) feature,
  • Remote hostnameof your device. It is the name of your device seen from Internet (if any),
  • Neighboring WiFi Access Point uniq identifier (MAC Address),
  • Neighboring WiFi Network Name (WiFi SSID).


In the "Current Location" tab, you can see the calculated location (here "Home"), the current local IP address, the current discovered remote IP address and hostname, and the list of WiFi Access Points with their SSID Network Names.

Create a new Location - Easy Wizard

The best way to create a new location is the use the "Create new Location ..." wizard. The wizard is launched from the "Tools" -> "SMTP Control ..." menu :


Indicate the name of the new location :


For an easy, and automatic, location creation, do not select the "Use Advanced Mode" checkbox.
Then select the default SMTP Server associated with this location :


Create a new Location - Advanced Wizard

If you want to select which network properties to use to define the location, then select the "Use Advanced Mode" checkbox in the first screen of the wizard :


You can decide to use the local IP address, and if several addresses are available select which one you want to keep. And you can define the remote network informations of your location (hostname and remote IP address) :


Then you can define the WiFi properties of your location, by selecting the AP MAC Addresses (kind of uniq id of a WiFi access point) or the WiFi Network Name :


Then you finish by selecting the default SMTP server associated with the location.

*** To Be Completed ***


In the "Advanced" tab you will find the URL to access and other informations.


SMTP Control User Guide 0.1.0

Last Updated on Friday, 15 July 2011 12:45