Configuring Microsoft 365 Integration for Linux

This article describes how to configure Microsoft 365 (M365) for Linux users (Ubuntu 21.04 or later), in accordance with 2-factor authentication.

Prior versions of Ubuntu cannot configure Microsoft 365, and are restricted to using Thunderbird with email/IMAP. For instructions on how to configure the Thunderbird mail client: How to setup Microsoft 365 in Thunderbird

For more information about the M365 package, please refer to this article: Home | Microsoft 365

Step-by-step guide

1. Click on File > New Mail > Mail Account
   
   

   Open

   

   
   
   

2. Select Identity on the left-hand side.

   1. Full Name: enter your full name (first and last)

   2. Email Address: enter your 8-character UWaterloo username and @uwaterloo.ca (i.e. myuserna@uwaterloo.ca)
      
      

      Open

      

       

3. Unselect the Look up mail server details based on entered email address option
   
   

   Open

   

   
   
   

4. Select the server type as Exchange Web Services
   Note: If the Exchange Web Services option is unavailable, this add-on must be installed onto Evolution. On Ubuntu, this can be done through the Ubuntu Software Store
   
   

   Open

   

   
   
   

5. Enter your 8-character UWaterloo username and @uwaterloo.ca (i.e. myuserna@uwaterloo.ca)
   a. Change the host URL to https://outlook.office.com/
   b. Change the authentication method to OAuth2 (Office365)
   c. Click the Fetch URL button
   
   

   Open

   

   
   
   

6. Authenticate with DUO (Two-factor authentication)

   1. Two-factor authentication is known to be completed once the OAB URL is auto-populated with an address. Select Next and modify the default mail account configuration, if needed.