Skip to main content

Installation Guide

Multiple installation methods are available for Teams for Linux across different Linux distributions.

About Teams for Linux

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​

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

AUR: teams-for-linux

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

Pacstall: teams-for-linux-deb

Snap Store​

sudo snap install teams-for-linux

Get it from the Snap Store

Flathub​

flatpak install flathub com.github.IsmaelMartinez.teams_for_linux
Download on Flathub

Manual Installation​

Download from GitHub Releases​

  1. Go to GitHub Releases
  2. 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
AppImage Integration

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​

  1. Launch the application:

    teams-for-linux

  2. Sign in with your Microsoft Teams account

  3. 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
teams-for-linux --webDebug

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:

  1. Configuration - Customize Teams for Linux settings
  2. Multiple Instances - Set up work and personal profiles
  3. Screen Sharing - Configure screen capture
  4. Troubleshooting - Common issues and solutions

Support​