Purpose
These instructions are useful for running a version of Thunderbird 77.0b1 or later, supporting OAuth2 modern authentication.
Thunderbird Setup
- Launch Thunderbird to bring up the main Thunderbird interface.
- If you have other accounts configured, you can navigate to the Thunderbird interface by clicking on Local Folders on the left-hand side.
- Select Email under the "Setup Another Account" section in the main window.
- On the "Mail Account Setup" window, enter information into the available fields listed below and select Configure manually.
- Your name: Your name as you would like it to appear
- Email address: Your NetID email (NetID@utdallas.edu)
- (IMPORTANT) Password: Do not enter your password on this login screen. Only enter your email address and name.
- Enter information into the available fields as shown below and then select Advanced config.
- INCOMING
- Protocol: IMAP
- Server: outlook.office365.com
- Port: 993
- SSL: SSL/TLS
- Authentication: Normal password
- Username: Your NetID email
- OUTGOING
- Server: smtp.office365.com
- Port: 587
- SSL: STARTTLS
- Authentication: Normal password
- Username: Your NetID email
- Select OK.
- In the Server Settings tab, change Authentication method: to OAuth2.
- Go to the Outgoing Server (SMTP) tab and select Edit.
- Change Authentication method: to OAuth2, ensure connection security is STARTTLS and select OK.
- Restart Thunderbird.
- You will be prompted to sign in with your UTD password, enter it and select Sign in.
- Authenticate with Duo.
- Select Accept.
- Thunderbird is now set up, but please complete the steps below.
Important: Please complete these steps before using your Thunderbird client.
Reconfigure Folder Mapping
Clients configured using Microsoft Exchange protocol use different folders for some primary mail folders. For consistency, we highly recommend configuring Thunderbird to use these same folders. This will make it less confusing if you also use the web client for Microsoft 365 or a different desktop client using the Exchange protocol.
- Right-click on your Microsoft 365 account > Subscribe.
- Place a checkmark within the box next to each of these folders: Drafts | Deleted Items | Sent Items.
- Select Subscribe.
- Select OK.
- Right-click on your Microsoft 365 account > Settings.
- In the Server Settings tab, change When I delete a message: to Move it to this folder: Deleted Items
Note: If you do not see the option for Deleted Items, restart Thunderbird and try again.
- In the Copies & Folders tab, change Place a copy in: to Other: Sent Items on Microsoft 365 account.
- In the Copies & Folders tab, change Keep draft messages in: to Other: Drafts on Microsoft 365 account.
- Restart Thunderbird
Disable the Adaptive Junk Mail Controls
Microsoft 365 server-side junk/spam filtering is already enabled for all Microsoft 365 accounts.
- Right-click on the Email address you just configured in the left-hand pane and select Settings.
- In the “Junk Settings” tab, uncheck the box for Enable adaptive junk mail controls for this account.
- Restart Thunderbird.