teams-for-linux

Teams for Linux

Unofficial Microsoft Teams client for Linux — a native desktop app that wraps the Teams web version with enhanced Linux integration.

✅ System notifications
✅ System tray integration (badge support varies by desktop environment)
✅ Custom backgrounds & themes
✅ Screen sharing support
✅ Multiple account profiles

[!NOTE] This is an independent project, not affiliated with Microsoft. Some features are limited by the Teams web app.

Sponsor

Recall.ai — API for Meeting Recording and Transcription

If you're looking for a meeting recording API, consider checking out Recall.ai, an API that records and transcribes Zoom, Google Meet, Microsoft Teams, in-person meetings, and more.

This sponsorship helps support the ongoing development of teams-for-linux.

Installation

Package Repositories

We have dedicated Debian/DEB and RHEL/Fedora/RPM repositories at https://teamsforlinux.de hosted with :heart: by Nils Büchner. Please follow the installation instructions there.

Distribution Packages

Manual Download

Download from GitHub Releases — available as AppImage, deb, rpm, snap, tar.gz (plus Windows/macOS builds).

[!TIP] For AppImage files, use AppImageLauncher for better desktop integration.

Quick Start

1. Install using your preferred method above
2. Launch with teams-for-linux
3. Configure by creating ~/.config/teams-for-linux/config.json if needed

Documentation

Complete Documentation — Enhanced documentation with search, mobile optimization, and comprehensive guides

Topic	Description
Installation Guide	Package repositories and installation methods
Configuration Guide	Complete setup and configuration options
Troubleshooting	Common issues and solutions
Multiple Profiles	Running work & personal accounts
Custom Backgrounds	Video call backgrounds setup
Contributing	Development setup and contribution guidelines
Privacy & Data Protection	What personal data the app does and does not handle

Project Activity

Support & Community

• Chat: Join our Matrix Space
• Issues: Report bugs
• Contributing: See CONTRIBUTING.md

Security & Sandboxing

Electron's contextIsolation and sandbox features are disabled to enable Teams DOM access functionality. For enhanced security, use system-level sandboxing:

Available options:

• Flatpak: Built-in isolation via Flathub
• Snap packages: Application confinement with auto-updates
• Firejail: Use this script for manual sandboxing
• AppArmor/SELinux: Most Linux distributions include these by default

System-level sandboxing provides better isolation than Electron's built-in features while preserving full functionality.

Advanced Usage

History

Read about the history of this project in the HISTORY.md file.

License

GPL-3.0 — See LICENSE.md

Icons from Icon Duck (CC BY 4.0)