Teams for Linux

June 4, 2026 · View on GitHub

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.

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

Install using your preferred method above
Launch with teams-for-linux
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

Project Activity

Alt

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.