Outlook OAuth Bridge

Enter the password printed in the container logs on first run.

Outlook OAuth Bridge
Setup

Connect your Outlook.com account

  1. Register an Azure app (one-time, free) at portal.azure.com → App registrations → New registration.
    • Supported account types: Personal Microsoft accounts only
    • Authentication → Advanced settings → Allow public client flows = Yes
    • No redirect URI needed · no client secret needed
  2. Paste the Application (client) ID
Reconnection needed

Connection

01 · Open the sign-in page

Open microsoft.com/link

02 · Enter this code

 

Waiting for sign-in · code expires in 15:00

Microsoft asks you to sign in again on that page even if you're already signed in elsewhere — expected for personal accounts.

SMTP client

        

      

    


    
    

      
Test

      

        
        
        
      

      


      

        

        
Verify an alias

        

          Sends a real message from the selected alias, bypassing the queue, so you can check what the recipient's inbox actually shows. The bridge can't read that inbox itself — it can only ask you.
        

        

          
          
          
        

        

        

          What did the From line say in that inbox?
          
            
            
          
        

      

    


    
    

      
Activity

      
    
      
    No activity yet.
    
    
    

    
    
      
      
    
        
    Queue
    
        
    
          
    
            
    SubjectAttemptsNext
    
            
          
    
        
    
      
    

      
      
    
        
    Dead letters
    
        
    
          
    
            
    SubjectReason
    
            
          
    
        
    
      
    
    
    

    
    
    
      
    Settings
    
      
    
        
    
          
    Sender addresses
    
          
    
            Each address must first be enabled in Outlook on the web under Settings → Mail → Compose and reply → "Addresses to send from". Adding it here only tells the bridge it's allowed to use it — it doesn't grant anything on Microsoft's side.
          
    
          
    
          
          
        
    

        
        
        
    
          Reconnect (Connection panel above) to grant the extra permission this needs — it won't take effect until then.
        
    
        
        
        
    
          If you're running in Docker, also update the port mapping in docker-compose.yml to match — see the README's "Privileged ports" section.
        
    
        
    
          
          
          
          
        
    
        
      
    

      
    
        
    
          Restarting applies changes that need it (SMTP port, Require TLS). Only actually restarts if this is running under something that restarts it automatically — Docker's restart: unless-stopped, systemd, etc. — otherwise it just stops.
        
    
        
      
    

      
    

      
    
        
    Change web GUI password