Trouble-Shooting Account Setup

There are currently no known issues that would prevent Postbox from interoperating with POP, IMAP or SMTP servers.

If your email server supports POP/IMAP/SMTP, and if the correct settings are entered into Postbox, it will connect. We guarantee it!

But there are some external things that could prevent Postbox from connecting to your account. Please follow these trouble-shooting steps to get your account up and running in Postbox as quickly as possible:


1) Ensure that you have the correct settings for your account

It is the responsibility of the Postbox user to enter the correct settings into Postbox.

Work with your ISP, network administrator, IT manager, or SysAdmin to get the correct settings for your email account: 

Incoming Server

  • Account Type (POP or IMAP): 
  • Server Name: 
  • Port: 
  • User Name: 
  • Connection Security (SSL/TLS or STARTTLS): 
  • Authentication (Password, OAuth2, etc.):

Outgoing Server

  • Server Name: 
  • Port: 
  • User Name: 
  • Connection Security (SSL/TLS or STARTTLS): 
  • Authentication (Password, OAuth2, etc.):

Please note that Postbox staff do not have access to your email credentials! 

For additional resources, please see Setting Up Accounts.


2) Ensure that your email server supports, and is correctly configured to use, IMAP, POP, or SMTP

Google Accounts

Postbox and Google accounts work beautifully together, it's a match made in heaven! However, there are some steps you must take to enable applications such as Postbox to interface with your Google account.

For more information, please see this help article:
Setting up GOOGLE / GMAIL Email Accounts

Apple iCloud Accounts

Apple requires that you generate app specific passwords for third-party apps that use your iCloud data. This includes apps such as Postbox and BusyCal.

For more information, please see this help article:
Setting up iCloud, .Me or .Mac Accounts


Postbox works with IMAP and POP email standards, but not the proprietary Exchange protocol. However, if your Exchange server has IMAP or POP turned on, Postbox should work just fine. Please contact your IT administrator to determine if IMAP and POP are turned on, and if so, at what settings.

For more information, please see this help article:

Setting up Microsoft Exchange (over IMAP)  

For all other accounts, please consult with your ISP or IT administrator.


3) Clear out old passwords

  • Navigate to Preferences or Options / Privacy / Saved Passwords / Show Passwords Button.
  • Take a screenshot of your passwords as a backup.
  • Click the Remove All button.
  • Restart Postbox, and then enter your passwords when prompted.


4) Ensure that a previous setup attempt is not interfering with new account setup

The best way to ensure that older account data or settings are not interfering with the setup of a new account is to create a new Postbox profile as a diagnostic test.

A new profile will act as a fresh Postbox install, but it can reside alongside your existing install, so you don't have to worry about anything changing in your current setup.

  1. Go to Preferences (macOS) or Options (Windows) / General, and select the checkbox for "Show Profile Manager on Startup."
  2. Restart Postbox.
  3. Create a new profile. Make sure that the "Don't ask at startup" checkbox is NOT checked.
  4. Next, set up the account. 


5) Disable third-party software

Sometimes there are issues external to Postbox which are causing it to malfunction.  For example, anti-virus or backup software can prevent Postbox from saving preferences, folder permissions issues on disk can prevent Postbox from being able to save messages, third-party utilities blocking ports, corrupted fonts, etc.  

The easiest way to trouble-shoot these types of issues is to restart your computer in safe mode: Windows 10, Windows 8, Windows 7macOS 

Once in safe mode, try setting up your account in Postbox.


A Note on Passwords

Postbox must be able to establish a connection to your mail server before it will ask you for a password. If you are not asked for a password, then a connection is unable to be established, and we recommend that you review your connection settings again.


Additional Resources

Setting Up Accounts

How to Trouble-Shoot Postbox