teams-for-linux

Unofficial Microsoft Teams client for Linux using Electron. This app wraps the web version of Teams as a standalone desktop application.

Overview

Teams for Linux was developed to provide a native-like desktop experience by wrapping the web version in an Electron shell.

While we strive to add useful features and improvements, some limitations are inherent because the app relies on the Microsoft Teams web version. In cases where Microsoft controls the feature set (or behavior), issues may be closed with an explanation.

We are not affiliated with Microsoft, and this project is not endorsed by them. It is an independent effort to provide a better experience for Linux users.

Please report bugs and enhancements in the issues section. We will attend them as soon as possible. Please review the open/close issues before raising a new one and avoid duplicates. We encourage everyone to join our chat room in matrix and ask your questions. That's probably the quickest way to find solutions.

---

Unofficial Microsoft Teams client for Linux using Electron. It uses the Web App and wraps it as a standalone application using Electron.

Downloads

Binaries available under releases for Linux packaging formats — AppImage, rpm, deb, snap, and tar.gz — and, believe it or not, for Windows and macOS as well.

In the case of AppImage, we recommend using AppImageLauncher for the best desktop experience.

We have a dedicated deb and rpm repo at https://teamsforlinux.de hosted with :heart: by Nils Büchner. Please follow the installation instructions below.

Debian/Ubuntu and other derivatives

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 and other derivatives

curl -1sLf -o /tmp/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc; rpm --import /tmp/teams-for-linux.asc; rm -f /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

Also available in:

Configuration and starting arguments

For detailed configuration options, including startup arguments to enable or disable specific features, please refer to the Configuration README in the config folder.

Running teams-for-linux in a firejail

A dedicated firejail script is available to help sandbox Teams for Linux. This script can both launch the application and join meetings with an already running instance.

Contributing

Contributions, PRs, and suggestions are always welcome!

For information on how to run the app from source or contribute code, please refer to the CONTRIBUTING.md file.

Known issues

A list of known issues and possible workarounds is available in the KNOWN_ISSUES.md file. Please check it before opening a new issue.

History

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

License

Teams for Linux is released under the GPLv3

Some icons are from Icon Duck and are licensed under CC BY 4.0.