hoelee/email-sync-oauth2 repository overview

⁠Email Sync OAuth2

Dockerized multi-account IMAP synchronization tool with OAuth2 support for Office 365, Hotmail, Outlook.com, and Gmail.

⁠Problem This Solves

Microsoft retired Basic Authentication for Exchange Online (IMAP/SMTP), and Google is pushing XOAUTH2 as the only authentication method. This breaks traditional IMAP sync tools that rely on username/password.

Mailcow's built-in sync job and many other tools don't support OAuth2, making it impossible to migrate emails from Hotmail/Outlook.com/Gmail into self-hosted mail servers.

This project solves that problem by combining:

• imapsync⁠ — battle-tested IMAP migration tool
• imapsync's OAuth2 helper — token authorization and refresh for Microsoft and Google accounts
• Docker — portable, reproducible, easy to deploy

⁠Features

⁠Quick Start

git clone https://github.com/hoelee/email-sync-oauth2.git
cd email-sync-oauth2
cp .env.example .env
nano .env   # edit your settings

⁠1. First-time OAuth authorization

docker compose run --rm imapsync authorize 1
# → Paste URL in browser, log in, click "Allow"
# → Token saved to ./tokens/

⁠2. Start syncing

docker compose up -d

⁠Monitor

docker logs -f email-sync-oauth2
tail -f logs/account1.log

⁠Pull from Docker Hub

docker pull hoelee/email-sync-oauth2:latest

⁠Authentication Support

⁠Source

GitHub: hoelee/email-sync-oauth2⁠

⁠License

MIT License.

⁠Credits

• imapsync⁠ by Gilles Lamiral
• imapsync OAuth2 helper⁠