Installation Guide
Multiple installation methods are available for Teams for Linux across different Linux distributions.
Unofficial Microsoft Teams client for Linux — a native desktop app that wraps the Teams web version with enhanced Linux integration including system notifications, tray integration, custom backgrounds, screen sharing, and multiple account profiles.
Quick Installation
Package Repositories (Recommended)
We maintain dedicated deb and rpm repositories hosted with ❤️ by Nils Büchner.
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
URIs: https://repo.teamsforlinux.de/debian/
Suites: stable
Components: main
Signed-By: /etc/apt/keyrings/teams-for-linux.asc
Architectures: amd64" | sudo tee /etc/apt/sources.list.d/teams-for-linux-packages.sources'
sudo apt update && sudo apt install teams-for-linux
RHEL/Fedora/CentOS
curl -1sLf -o /tmp/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc
sudo rpm --import /tmp/teams-for-linux.asc
sudo curl -1sLf -o /etc/yum.repos.d/teams-for-linux.repo https://repo.teamsforlinux.de/rpm/teams-for-linux.repo
sudo dnf install teams-for-linux
Beta Channel (Pre-releases)
New versions are published to a beta channel first and promoted to stable after a few days of testing. Follow the beta channel if you want pre-releases and want to help test them before promotion.
Debian/Ubuntu — same source as stable, with Suites: beta:
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
URIs: https://repo.teamsforlinux.de/debian/
Suites: beta
Components: main
Signed-By: /etc/apt/keyrings/teams-for-linux.asc
Architectures: amd64" | sudo tee /etc/apt/sources.list.d/teams-for-linux-packages.sources'
sudo apt update && sudo apt install teams-for-linux
RHEL/Fedora/CentOS — use the beta repository:
curl -1sLf -o /tmp/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc
sudo rpm --import /tmp/teams-for-linux.asc
sudo curl -1sLf -o /etc/yum.repos.d/teams-for-linux-beta.repo https://repo.teamsforlinux.de/rpm-beta/teams-for-linux-beta.repo
sudo dnf install teams-for-linux
To return to stable releases, change Suites: beta back to Suites: stable (Debian/Ubuntu), or remove /etc/yum.repos.d/teams-for-linux-beta.repo and reinstall from the stable repository (RHEL/Fedora/CentOS).
Distribution-Specific Packages
Arch Linux (AUR)
# Using yay
yay -S teams-for-linux
# Using paru
paru -S teams-for-linux
# Manual AUR build
git clone https://aur.archlinux.org/teams-for-linux.git
cd teams-for-linux
makepkg -si
Ubuntu (Pacstall)
# Install Pacstall first (if not already installed)
sudo bash -c "$(curl -fsSL https://pacstall.dev/q/install)"
# Install Teams for Linux
pacstall -I teams-for-linux-deb
Vylen Linux
sudo emerald install teams-for-linux
Snap Store
sudo snap install teams-for-linux
Flatpak is the slowest update channel — it only receives a new version after the release has reached 100% across all other channels. Snap stable is the next slowest, with manual promotion after testing. If you prefer fewer update notifications, these are good choices. See the Release Cadence section for details.
Flathub
flatpak install flathub com.github.IsmaelMartinez.teams_for_linux
Flathub Beta Channel (Pre-releases)
Pre-releases are published to the Flathub beta remote before they reach the stable Flathub build. Following the beta remote is the most useful thing a Flatpak user can do for this project, because sandbox and permission changes can be built by the Flathub buildbot but cannot be tested by the maintainer, who has no Linux desktop available.
flatpak remote-add --if-not-exists flathub-beta https://flathub.org/beta-repo/flathub-beta.flatpakrepo
flatpak install flathub-beta com.github.IsmaelMartinez.teams_for_linux//beta
The beta build is a separate branch of the same application ID, so it installs alongside the stable one rather than replacing it. That matters when you launch it: the desktop launcher and a bare flatpak run com.github.IsmaelMartinez.teams_for_linux both keep starting the stable build, so run the beta explicitly, otherwise you will think you are testing the pre-release when you are not.
flatpak run com.github.IsmaelMartinez.teams_for_linux//beta
To go back to stable, remove the beta branch:
flatpak uninstall com.github.IsmaelMartinez.teams_for_linux//beta
If the install fails with the app not being found on flathub-beta, there is no beta build published at the moment. The beta remote only carries a build while a pre-release is being tested, so use the stable Flathub install above and try again after the next release.
The beta remote carries pre-release builds and packaging changes that are still being validated, so expect the occasional rough edge. If you hit one, please open an issue and mention that you are on the beta remote.
Manual Installation
Download from GitHub Releases
- Go to GitHub Releases
- Download the appropriate package for your system:
- AppImage - Universal Linux package
- deb - Debian/Ubuntu package
- rpm - Red Hat/Fedora package
- snap - Universal snap package
- tar.gz - Portable archive
Package Installation
Debian/Ubuntu (.deb)
sudo dpkg -i teams-for-linux_*.deb
sudo apt-get install -f # Fix dependencies if needed
Red Hat/Fedora (.rpm)
# Fedora
sudo dnf install teams-for-linux_*.rpm
# RHEL/CentOS
sudo rpm -i teams-for-linux_*.rpm
AppImage
# Make executable
chmod +x teams-for-linux_*.AppImage
# Run directly
./teams-for-linux_*.AppImage
# For better desktop integration, use AppImageLauncher
For AppImage files, install AppImageLauncher for better desktop integration, including automatic menu entries and file associations.
Portable Installation (tar.gz)
# Extract
tar -xzf teams-for-linux_*.tar.gz
# Run
cd teams-for-linux/
./teams-for-linux
First Launch
Quick Start
-
Launch the application:
teams-for-linux -
Sign in with your Microsoft Teams account
-
Configure if needed by creating
~/.config/teams-for-linux/config.json
Initial Configuration
For basic usage, no configuration is required. Teams for Linux will work out of the box.
For advanced features, create a configuration file:
mkdir -p ~/.config/teams-for-linux/
Example basic configuration:
{
"minimizeToTray": true,
"startInTray": false,
"enableDesktopNotifications": true
}
See the Configuration Guide for all available options.
Command Line Options
Basic Usage
# Standard launch
teams-for-linux
# Use custom config directory
teams-for-linux --user-data-dir=/path/to/custom/profile
Multiple Instances
# Work profile
teams-for-linux --user-data-dir=~/.config/teams-work --class=teams-work
# Personal profile
teams-for-linux --user-data-dir=~/.config/teams-personal --class=teams-personal
See Multiple Instances for detailed setup.
Debug Mode
# Enable debug logging
teams-for-linux --logConfig='{"level":"debug"}'
# Show developer tools with Electron logging
ELECTRON_ENABLE_LOGGING=true teams-for-linux
Troubleshooting Installation
Common Issues
Package Dependencies
# Ubuntu/Debian - fix missing dependencies
sudo apt-get install -f
# Fedora - install missing packages
sudo dnf install missing-package-name
Audio Not Working
# Check PulseAudio status
pulseaudio --check
# Restart PulseAudio
pulseaudio --kill && pulseaudio --start
Permission Issues
# Add user to audio group
sudo usermod -a -G audio $USER
# Add user to video group (for webcam)
sudo usermod -a -G video $USER
# Log out and back in for changes to take effect
Repository Issues
GPG Key Problems
# Re-import repository key
curl -1sLf -o /tmp/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc
sudo rpm --import /tmp/teams-for-linux.asc # For RPM systems
Network/Proxy Issues
# For corporate environments with proxies
export https_proxy=http://proxy.company.com:8080
Next Steps
After installation:
- Configuration - Customize Teams for Linux settings
- Multiple Instances - Set up work and personal profiles
- Screen Sharing - Configure screen capture
- Troubleshooting - Common issues and solutions
- Uninstall Guide - Remove Teams for Linux from your system
Support
- Documentation: Full documentation
- Issues: GitHub Issues
- Community: Matrix Space
- Discussions: GitHub Discussions
Related Documentation
- Configuration Options - Complete configuration reference
- Multiple Instances - Running multiple profiles
- Troubleshooting - Common issues and solutions