Feat. Add Personal Microsoft Accounts Ingestion #29

New Issue

MrUnknownDE · 2026-04-05T16:16:12+02:00

MrUnknownDE commented

2026-04-05 16:16:12 +02:00

Originally created by @sorglos123 on 2/26/2026

This pull request introduces support for Outlook Personal (personal Microsoft accounts) as a new email provider, improves local development workflows, and updates documentation and environment configuration to reflect these enhancements. The most important changes are grouped below:

Outlook Personal Provider Integration

Added new OAuth2 + PKCE endpoints in IngestionController for Outlook Personal authorization and callback, enabling secure connection and ingestion for personal Microsoft accounts.
Added documentation for Outlook Personal setup, including Azure app registration, permissions, troubleshooting, and security considerations in docs/user-guides/email-providers/outlook-personal.md.
Updated README.md and documentation navigation to reference Outlook Personal as a supported provider and provide links to setup guides. [1] [2] [3] [4]

Local Development Improvements

Added docker-compose.dev.yml for running dependency services (Postgres, Valkey, Meilisearch, Tika) during local development, and improved .env.example with bind host and allowed hosts configuration. [1] [2]
Updated .dockerignore to ignore build, cache, coverage, docs, and asset files for cleaner Docker builds.
Refined Dockerfile and build scripts to copy only necessary sources for OSS builds, improving cache reuse and build speed.

Environment and Configuration Updates

Added Outlook Personal OAuth environment variables (OUTLOOK_PERSONAL_CLIENT_ID, OUTLOOK_PERSONAL_CLIENT_SECRET, OUTLOOK_PERSONAL_REDIRECT_URI) to .env.example for easier configuration.
Backend now binds to configurable host via HOST_BACKEND environment variable for improved flexibility in local and production setups.

Dependency Updates

Added ioredis as a dependency in packages/backend/package.json,Primary use: OAuth state storage in Redis/Valkey, via a direct import in packages/backend/src/helpers/oauthStateStore.ts.

Build and Start Script Enhancements

Improved package.json scripts for development, including new commands for parallel app and worker startup, and a script to stop development processes cleanly.

These changes collectively enable Outlook Personal account support, streamline local development, and enhance configuration and documentation for both new and existing users.

*Originally created by @sorglos123 on 2/26/2026* This pull request introduces support for Outlook Personal (personal Microsoft accounts) as a new email provider, improves local development workflows, and updates documentation and environment configuration to reflect these enhancements. The most important changes are grouped below: **Outlook Personal Provider Integration** * Added new OAuth2 + PKCE endpoints in `IngestionController` for Outlook Personal authorization and callback, enabling secure connection and ingestion for personal Microsoft accounts. * Added documentation for Outlook Personal setup, including Azure app registration, permissions, troubleshooting, and security considerations in `docs/user-guides/email-providers/outlook-personal.md`. * Updated `README.md` and documentation navigation to reference Outlook Personal as a supported provider and provide links to setup guides. [[1]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5R47) [[2]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L112-R133) [[3]](diffhunk://#diff-492f4fe6d732168c58e78f2a627614dc59f1e41a5d12da3d8347d3957e9673f6R7-R12) [[4]](diffhunk://#diff-51aa140f4cf909827656734d9dc510e772a422f369efd477dda464e1bb115f58R9) **Local Development Improvements** * Added `docker-compose.dev.yml` for running dependency services (Postgres, Valkey, Meilisearch, Tika) during local development, and improved `.env.example` with bind host and allowed hosts configuration. [[1]](diffhunk://#diff-9542f82d64bbeebd91f6236324bfe199e9657e2cb1fd9779d5d6dcdcf9cd4de1R1-R79) [[2]](diffhunk://#diff-a3046da0d15a27e89f2afe639b25748a7ad4d9290af3e7b1b6c1a5533c8f0a8cR7-R12) * Updated `.dockerignore` to ignore build, cache, coverage, docs, and asset files for cleaner Docker builds. * Refined Dockerfile and build scripts to copy only necessary sources for OSS builds, improving cache reuse and build speed. **Environment and Configuration Updates** * Added Outlook Personal OAuth environment variables (`OUTLOOK_PERSONAL_CLIENT_ID`, `OUTLOOK_PERSONAL_CLIENT_SECRET`, `OUTLOOK_PERSONAL_REDIRECT_URI`) to `.env.example` for easier configuration. * Backend now binds to configurable host via `HOST_BACKEND` environment variable for improved flexibility in local and production setups. **Dependency Updates** * Added `ioredis` as a dependency in `packages/backend/package.json`,Primary use: OAuth state storage in Redis/Valkey, via a direct import in packages/backend/src/helpers/oauthStateStore.ts. **Build and Start Script Enhancements** * Improved `package.json` scripts for development, including new commands for parallel app and worker startup, and a script to stop development processes cleanly. These changes collectively enable Outlook Personal account support, streamline local development, and enhance configuration and documentation for both new and existing users.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github/OpenArchiver#29