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.
We have a dedicated deb and rpm repo at https://teamsforlinux.de hosted with ❤️ by Nils Büchner. Please follow the installation instructions below.
Debian/Ubuntu:
sudo mkdir -p /etc/apt/keyrings
sudo wget -qO /etc/apt/keyrings/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc
sh -c 'echo "Types: deb\nURIs: https://repo.teamsforlinux.de/debian/\nSuites: stable\nComponents: main\nSigned-By: /etc/apt/keyrings/teams-for-linux.asc\nArchitectures: amd64" | sudo tee /etc/apt/sources.list.d/teams-for-linux-packages.sources'
sudo apt update && sudo apt install teams-for-linuxRHEL/Fedora:
curl -1sLf -o /tmp/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc; rpm --import /tmp/teams-for-linux.asc
curl -1sLf -o /etc/yum.repos.d/teams-for-linux.repo https://repo.teamsforlinux.de/rpm/teams-for-linux.repo
yum update && yum install teams-for-linux
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.
- Install using your preferred method above
- Launch with
teams-for-linux - Configure by creating
~/.config/teams-for-linux/config.jsonif needed
📖 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 |
- 💬 Chat: Join our Matrix room
- 🐛 Issues: Report bugs
- 🤝 Contributing: See
CONTRIBUTING.md
Security & Sandboxing
As of v2.5.2+, 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.
Read about the history of this project in the HISTORY.md file.
GPL-3.0 — See LICENSE.md
Icons from Icon Duck (CC BY 4.0)
