Email Accounts Settings
MailboxPro can connect to as many email accounts as you wish, and they are all managed
from the “Email Accounts”option from the MailboxPro menu.
On first run, you will see the “Disabled” tab, which contains the
default account automatically created on installation. This account should be the
same account that sends the notifications from Gemini as all replies to notifications
should be processed by MailboxPro.
The Email Account page shows all the email accounts created, grouped by their state;
Active, Disabled, and Errored.
Add New Account
To add a new account, click the “Add” link just underneath the tabs.
Account Name: The name of the account. Can be anything that is
meaningful to help you identify it.
Incoming Server: The incoming mail server, eg mail.domain.com or
192.168.1.100 for example.
Incoming Port: if the port is different to the standard 110 for
pop3, enter it here, else it can be left blank.
Username: The username or email addressed used to authenticate
the account
Password: The password for the account.
Usually these settings are sufficient to get started, but should you need to add
SSL, outgoing servers etc, click on the Advanced Settings tab.
Associated Project: To link each email received from this account
to a given project, select the project from the drop down list. All emails received
will now be assigned to this project. it is not possible to associate the default
account with a specific project.
Incoming SSL: If the incoming mail server requires SSL connectivity,
check this box.
Outgoing Server: If the outbound email server is different to the
incoming server, specify it here. Otherwise, the incoming server will be used.
Outgoing Port: If the outgoing port is different to SMTP 25, enter
the alternate port here.
Outgoing SSL: If the outbound server requires SSL connectivity,
check this box.
Check Frequency: By default the background service runs every minute,
but to slow the process down (some email accounts do not like polling every minute)
raise this number. A check frequency of 0 will mean each time the background process
runs, the email account will be checked for new emails.
Lock to Project: If the inbound email contains an issue ticket
number (a reply) but the ticket is for a different project by default MailboxPro
will treat it as a comment to that issue. If the lock to project is enabled, a new
issue will be created in the locked project, linked to the existing issue.
Account Active: Shows the state of the account, you can enable/disable
an account by toggling this checkbox.
When all the settings have been entered, click Save and the email
account will be created.
Editing an Account
To edit an account, click the edit icon
by the required
account. This will display the same screen as when adding an account. Amend the
details as required (see Add New Account for details) and click Save
when complete. The amended details will be shown on the account listing.
Deleting an Account
To delete an account, click the delete icon
by the required account.
Click “Delete” on the confirmation, and the email account will
be removed. If the account has already been used and emails have been processed
from it, the account will be marked as disabled.
Managing Accounts
The main account screen will show you information about an email account. It shows
when it was last run, and whether there were any failures.
Check Frequency: The number of minutes since the processor last
finished to wait before processing the email account again. If there has been a
network error, MailboxPro will delay processing in the hope it will resolve itself.
This delay override is displayed - for example, 2 /10 would mean the account is
usually checked every two minutes, but the override to check every 10 minutes.
Fail Count: the number of times the email account has processed
in a row. Should any error correct itself, this count is reset.
Action: There are the following buttons available, depending on
the state of the email account.
Edit the account details
Delete the account
Enable the account
Disable the account
Reset the account’s failure
and override details
Troubleshooting
The easiest way to troubleshoot an accounts is to look at the log file located in
the Logs folder within the MailboxPro installation folder. This will give details
information about what went on with the processor.