Teams for Linux
A native Linux desktop wrapper around the Microsoft Teams web app, with the integration features the web client cannot provide on its own: system tray and notifications, custom backgrounds, screen sharing, multiple account profiles, certificate handling, Intune SSO, secure token storage, and an MQTT bridge for home automation.
Independent project, not affiliated with Microsoft. Some behaviour is constrained by what the Teams web app exposes.
Quick start
Install the package for your distribution from the Installation guide, then launch:
teams-for-linux
For a custom configuration, drop a JSON file at ~/.config/teams-for-linux/config.json. The full schema lives in the Configuration reference. A minimal example:
{
"closeAppOnCross": false,
"followSystemTheme": true,
"trayIconEnabled": true
}
If the app misbehaves, the Troubleshooting guide covers the common cases (Wayland rendering, screen sharing, notifications, certificates).
Guides
User-facing topics:
- Installation — package repositories and manual install for every supported distribution
- Configuration — every option, with defaults
- Multiple instances — running separate work and personal profiles side by side
- Screen sharing — Wayland and X11 setup, including portal selection
- Custom backgrounds — adding your own video-call backgrounds
- Certificate management — corporate CA bundles and proxy interception
- Intune SSO — Microsoft Identity Broker integration
- MQTT integration — publish presence and call status to a broker
- Troubleshooting — diagnostics for common Linux desktop issues
Contributing
If you want to fix a bug or add a feature:
- Contributing guide — local setup, code standards, PR workflow
- Architecture overview — how the main and renderer processes are wired
- Architecture Decision Records — the rationale behind significant choices
- Release process — how versions are cut via release-please
Community
- GitHub Issues — bug reports and feature requests
- Matrix space — chat with users and contributors