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
✅ 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.

Installation

Package Repositories

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-linux

RHEL/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

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

Support & Community

• 💬 Chat: Join our Matrix room
• 🐛 Issues: Report bugs
• 🤝 Contributing: See CONTRIBUTING.md

Advanced Usage

Running in Firejail

Use this firejail script to sandbox Teams for Linux. The app is already using electron's contextIsolation and sandbox.

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)