Developers Tools

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

SMTP Control User Guide

Print PDF

***** Please Notice that User Guide is based on version 0.1.0. Hopefully the documentation will be updated shortly *****

Using SMTP Control

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, ...) by network rules (IP addresses and network masks), and associate a default SMTP server per location.

SMTP Control will calculate location based on user rules and propose the default server in the swap list.

The above picture shows The discovered IP addresses of the system and the calculated location. If you have just change some of the location parameters (see other tabs) you can trigger a relocation to check the modifications. When Applying and Closing the option window, SMTP Control will automatically trigger a relocation calculation.

New Locations can be added with the tab "Locations Definition".

To add a new location, click on "Add Location" button. A default name for the location is proposed, you should change it to something easy to understand for you.
To define the location you have to add at least one IP rule. Click on "Add" near the "IP rules" selection list and give one, two or three IP addresses with their network mask to define this location. Most of the location would have only one IP address. Current version only support masks with values 8,16,24,32. If you don't know which mask to choose, prefer 24 value. Network mask aspect will be more detailled in a futur documentation.
You can also use 2 or 3 addresses in situation where your system has for exemple an IP address for the local network (my home network) and an IP address for a VPN connection to the enterprise. Have 2 IP addresse will give you the ability to define a location like "Office connection from Home".

If your location can have different network properties, then you can define several separate IP rules. For exemple "Office" can be for you the "Office building in Paris" using IP or the "Office building in New-York" using IP When SMTP Control detect any one of these IP it will know that the location is "Office". Without the need for 2 locations.

To finish the location definition you have to select which SMTP server will be the location default in the drop down menu.

To remove a location, select the location in the dop down menu and click "Remove Location".

A new Location can also be created directly from the tool menu :

By doing that SMTP Control will automatically use the current IP address as rule for defining the new location.

By the menu you can also correct a location discovery. By doing that the IP addresses will be added in a new rule for the selected location.

Locate the default SMTP server based on location need to be configured per email account. To enable this feature you need to select which email account allow this feature by using the "Location per Account" tab :

Note : By default no email account has this feature enabled. Which is not a good default behavior ... (realize this while writing the doc). Expect a different default behavior in next realize ...

"Ignored IP Addresses" tab is an advanced configuration. For those who are using tools like VmWare workstation or server, you will have static IP addresses all the time configured on your system for virtual networking. You will need to ignore these IP addresses to have better accuracy in the location detection. You can define the IP addresses or network that SMTP Control has to ignore while doing the location calculation.


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


Last Updated on Tuesday, 22 December 2009 19:18