Skip to content

docs: add self-hosted MS Teams setup guide#665

Closed
masami-agent wants to merge 1 commit intoopenabdev:mainfrom
masami-agent:docs/msteams-selfhosted
Closed

docs: add self-hosted MS Teams setup guide#665
masami-agent wants to merge 1 commit intoopenabdev:mainfrom
masami-agent:docs/msteams-selfhosted

Conversation

@masami-agent
Copy link
Copy Markdown
Contributor

Description

Adds a self-hosted MS Teams setup guide based on @neilkuan's approach from the feat/teams-gateway branch.

This doc covers the self-hosted deployment path using Docker Compose + Cloudflare Tunnel (or any reverse proxy), targeting individuals and small teams who want to connect MS Teams to OpenAB without enterprise Azure infrastructure.

What's included

  • Azure AD app registration walkthrough
  • Azure Bot resource creation
  • Teams app manifest (Developer Portal + hand-rolled JSON)
  • Docker Compose stack (gateway + OAB + optional Cloudflare Tunnel)
  • Public HTTPS exposure options (Cloudflare Tunnel, ngrok, Tailscale Funnel, etc.)
  • Environment variables reference
  • Troubleshooting guide

Context

This is part of the PR #550 split discussed with @obrutjack:

  1. PR refactor(gateway): split main.rs into adapter modules #550 → slim down to gateway adapter modular refactor only
  2. This PR → self-hosted MS Teams setup doc
  3. Future PR → enterprise MS Teams deployment (Helm chart + AKS docs)

Notes

  • All sensitive values use <YOUR_xxx> placeholders
  • No code changes — docs only
  • Based on docs/msteams.md from feat/teams-gateway branch (credit: @neilkuan)

@masami-agent masami-agent requested a review from thepagent as a code owner May 1, 2026 00:39
@github-actions github-actions Bot added pending-screening PR awaiting automated screening closing-soon PR missing Discord Discussion URL — will auto-close in 3 days labels May 1, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 1, 2026

⚠️ This PR is missing a Discord Discussion URL in the body.

All PRs must reference a prior Discord discussion to ensure community alignment before implementation.

Please edit the PR description to include a link like:

Discord Discussion URL: https://discord.com/channels/...

This PR will be automatically closed in 3 days if the link is not added.

@masami-agent
Copy link
Copy Markdown
Contributor Author

Superseded by #667 — self-hosted docs are now included alongside the Teams adapter code in a single PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

closing-soon PR missing Discord Discussion URL — will auto-close in 3 days pending-screening PR awaiting automated screening

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant