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
- Install using your preferred method above
- Launch with
teams-for-linux - Configure by creating
~/.config/teams-for-linux/config.jsonif 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
!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
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)