Download Microsoft Teams now and get connected across devices on Windows, Mac, iOS, and Android. Collaborate better with the Microsoft Teams app.
-->Microsoft Teams has clients available for desktop (Windows, Mac, and Linux), web, and mobile (Android and iOS). These clients all require an active internet connection and do not support an offline mode.
- Jan 04, 2000 Microsoft Teams integrates with several products from the Microsoft Corporation, including Office 365 and Outlook. There’s also a search function, which lets you search for files, content, and other features across numerous channels. Compared to other popular apps like Skype for Business, Microsoft Teams uploads files within seconds.
- The free version of Teams includes the following: Unlimited chat messages and search. Built-in online meetings and audio and video calling for individuals and groups, with a duration of up to 60 minutes per meeting or call.
Note
For details about each clients' capabilities on different platforms, see Teams features by platform.
Effective November 29, 2018, you'll no longer be able to use the Microsoft Teams for Windows 10 S (Preview) app, available from the Microsoft Store. Instead, you can now download and install the Teams desktop client on devices running Windows 10 S mode. To download the desktop client, go to https://teams.microsoft.com/downloads. MSI builds of the Teams desktop client are not yet available for devices running Windows 10 S mode.
For more information about Windows 10 S mode, see Introducing Windows 10 in S mode.
Desktop client
Tip
Watch the following session to learn about the benefits of the Windows Desktop Client, how to plan for it, and how to deploy it: Teams Windows Desktop Client
The Microsoft Teams desktop client is a standalone application and is also available in Microsoft 365 Apps for enterprise. Teams is available for 32-bit and 64-bit versions of Windows (8.1 or later), ARM64 for Windows 10 on ARM, and Windows Server (2012 R2 or later), as well as for macOS and Linux (in .deb
and .rpm
formats). On Windows, Teams requires .NET Framework 4.5 or later; the Teams installer will offer to install it for you if you don't have it. On Linux, package managers such as apt
and yum
will try to install any requirements for you. However, if they don't then you will need to install any reported requirements before installing Teams on Linux.
The desktop clients provide real-time communications support (audio, video, and content sharing) for team meetings, group calling, and private one-on-one calls.
Desktop clients can be downloaded and installed by end users directly from https://teams.microsoft.com/downloads if they have the appropriate local permissions (admin rights are not required to install the Teams client on a PC but are required on a Mac).
Note
For more details about installing Teams on a Chromebook, please see How to install and run Microsoft Office on a Chromebook.
IT admins can choose their preferred method to distribute the installation files to computers in their organization. Some examples include Microsoft Endpoint Configuration Manager (Windows) or Jamf Pro (macOS). To get the MSI package for Windows distribution, see Install Microsoft Teams using MSI.
Note
Distribution of the client via these mechanisms is only for the initial installation of Microsoft Team clients and not for future updates.
Windows
The Microsoft Teams installation for Windows provides downloadable installers in 32-bit and 64-bit architecture.
Note
The architecture (32-bit vs. 64-bit) of Microsoft Teams is agnostic to the architecture of Windows and Office that is installed.
The Windows client is deployed to the AppData folder located in the user’s profile. Deploying to the user’s local profile allows the client to be installed without requiring elevated rights. The Windows client leverages the following locations:
%LocalAppData%MicrosoftTeams
%LocalAppData%MicrosoftTeamsMeetingAddin
%AppData%MicrosoftTeams
%LocalAppData%SquirrelTemp
When users initiate a call using the Microsoft Teams client for the first time, they might notice a warning with the Windows firewall settings that asks for users to allow communication. Users might be instructed to ignore this message because the call will work, even when the warning is dismissed.
Note
Windows Firewall configuration will be altered even when the prompt is dismissed by selecting “Cancel”. Two inbound rules for teams.exe will be created with Allow action for both TCP and UDP protocols.
If you want to prevent Teams from prompting users to create firewall rules when the users make their first call from Teams, use the Sample PowerShell script - inbound firewall rule below.
Mac
Mac users can install Teams by using a PKG installation file for macOS computers. Administrative access is required to install the Mac client. The macOS client is installed to the /Applications folder.
Install Teams by using the PKG file
- From the Teams download page, under Mac, click Download.
- Double click the PKG file.
- Follow the installation wizard to complete the installation.
- Teams will be installed to /Applications folder. It is a machine-wide installation.
Note
During the installation, the PKG will prompt for admin credentials. The user needs to enter the admin credentials, regardless of whether or not the user is an admin.
If a user currently has a DMG installation of Teams and wants to replace it with the PKG installation, the user should:
- Exit the Teams app.
- Uninstall the Teams app.
- Install the PKG file.
IT admins can use managed deployment of Teams to distribute the installation files to all Macs in their organization, such as Jamf Pro.
Note
If you experience issues installing the PKG, let us know. In the Feedback section at the end of this article, click Product feedback.
Linux
Users will be able to install native Linux packages in .deb
and .rpm
formats. Installing the DEB or RPM package will automatically install the package repository.
- DEB
https://packages.microsoft.com/repos/ms-teams stable main
- RPM
https://packages.microsoft.com/yumrepos/ms-teams
The signing key to enable auto-updating using the system's package manager is installed automatically. However, it can also be found at: https://packages.microsoft.com/keys/microsoft.asc. Microsoft Teams ships monthly and if the repository was installed correctly, then your system package manager should handle auto-updating in the same way as other packages on the system.
Note
If you find a bug, submit it using Report a Problem
from within the client. For known issues, see Support Teams in your organization.For Teams for Linux support you can use the Linux forum support channel on Microsoft Q&A. Be sure to use the teams-linux
tag when posting questions.
Install Teams using DEB package
- Download the package from https://aka.ms/getteams.
- Install using one of the following:
- Open the relevant package management tool and go through the self-guided Linux app installation process.
- Or if you love Terminal, type:
sudo dpkg -i **teams download file**
You can launch Teams via Activities or via Terminal by typing teams
.
Install Teams using RPM package
- Download the package from https://aka.ms/getteams.
- Install using one of the following:
- Open the relevant package management tool and go through the self-guided Linux app installation process.
- Or if you love Terminal, type:
sudo yum install **teams download file**
You can launch Teams via Activities or via Terminal by typing teams
.
Install manually from the command line
Install manually on Debian and Ubuntu distributions:
Install manually on RHEL, Fedora and CentOS based distributions:
Alternatively, to use yum instead of dnf:
Install manually on openSUSE based distributions:
Web client
The web client (https://teams.microsoft.com) is a full, functional client that can be used from a variety of browsers. The web client supports Calling and Meetings by using webRTC, so there is no plug-in or download required to run Teams in a web browser. The browser must be configured to allow third-party cookies.
Teams fully supports the following Internet browsers, with noted exceptions for calling and meetings. This table applies to operating systems running on desktop computers.
Browser | Calling - audio, video, and sharing | Meetings - audio, video, and sharing123 |
---|---|---|
Internet Explorer 11 | Not supported | Meetings are supported only if the meeting includes PSTN coordinates. To attend a meeting on IE11 without PSTN coordinates, users must download the Teams desktop client. Video: Not supported Sharing: Incoming sharing only (no outgoing) Microsoft 365 apps and services will not support Internet Explorer 11 starting August 17, 2021 (Microsoft Teams will not support Internet Explorer 11 earlier, starting November 30, 2020). Learn more. Please note that Internet Explorer 11 will remain a supported browser. Internet Explorer 11 is a component of the Windows operating system and follows the Lifecycle Policy for the product on which it is installed. |
Microsoft Edge, RS2 or later | Fully supported, except no outgoing sharing4 | Fully supported, except no outgoing sharing |
Microsoft Edge (Chromium-based), the latest version plus two previous versions | Fully supported | Fully supported |
Google Chrome, the latest version plus two previous versions | Fully supported | Fully supported Sharing is supported without any plug-ins or extensions on Chrome version 72 or later. |
Safari 14+ | 1:1 calls not supported. Group calls fully supported. Video: Fully supported Sharing: Fully supported | Meetings: Fully supported Video: Fully supported Sharing: Fully supported |
Safari 13.1+ | 1:1 calls not supported. Group calls supported with full audio support. Video: Incoming only Sharing: Fully supported | Meetings are supported with full audio support. Video: Incoming only Sharing: Fully supported |
Firefox, the latest version plus two previous versions | Not supported | Meetings are supported only if the meeting includes PSTN coordinates. To attend a meeting on Firefox without PSTN coordinates, users must download the Teams desktop client. Video: Not supported Sharing: Incoming sharing only (no outgoing) |
Safari versions before 13 | Not supported | Meetings are supported only if the meeting includes PSTN coordinates. To attend a meeting on Safari without PSTN coordinates, users must download the Teams desktop client. Video: Not supported Sharing: Incoming sharing only (no outgoing) Safari is enabled on versions higher than 11.1 in preview. While in preview, there are known issues with Safari's Intelligent Tracking Prevention. |
1 To give and take control of shared content during sharing, both parties must be using the Teams desktop client. Control isn't supported when either party is running Teams in a browser. This is due to a technical limitation that we're planning to fix.
2 Blur my background isn't available when you run Teams in a browser. This feature is only available in the Teams desktop client.
3 Teams meetings on browsers are limited to a single incoming video feed of active speaker.
4 Edge RS2 or later doesn't support sending real-time audio and video traffic through HTTP proxies.
Note
As long as an operating system can run the supported browser, Teams is supported on desktop computers. For example, running Firefox on the Linux operating system is an option for using Teams.
For mobile operating systems, we recommend that you run the Teams app, available from the Android and iOS stores. Running Teams in a mobile operating system is supported, but many features are unavailable.
The web client performs browser version detection upon connecting to https://teams.microsoft.com. If an unsupported browser version is detected, it will block access to the web interface and recommend that the user download the desktop client or mobile app.
Download Microsoft Teams For Mac
Mobile clients
The Microsoft Teams mobile apps are available for Android and iOS, and are geared for on-the-go users participating in chat-based conversations and allow peer-to-peer audio calls. For mobile apps, go to the relevant mobile stores Google Play and the Apple App Store. The Windows Phone App was retired July 20, 2018 and may no longer work.
In China, here's how to get Teams for Android.
Supported mobile platforms for Microsoft Teams mobile apps are the following:
Android: Support is limited to the last four major versions of Android. When a new major version of Android is released, the new version and the previous three versions are officially supported.
iOS: Support is limited to the two most recent major versions of iOS. When a new major version of iOS is released, the new version of iOS and the previous version are officially supported.
Note
The mobile version must be available to the public in order for Teams to work as expected.
Mobile apps are distributed and updated through the respective mobile platform’s app store only. Distribution of the mobile apps via MDM or side-loading is not supported by Microsoft. Once the mobile app has been installed on a supported mobile platform, the Teams Mobile App itself will be supported provided the version is within three months of the current release.
Decision Point | Are there any restrictions preventing users from installing the appropriate Microsoft Teams client on their devices? |
Next Steps | If your organization restricts software installation, make sure that process is compatible with Microsoft Teams. Note: Admin rights are not required for PC client installation but are required for installation on a Mac. |
Client update management
Clients are currently updated automatically by the Microsoft Teams service with no IT administrator intervention required. If an update is available, the client will automatically download the update and when the app has idled for a period of time, the update process will begin.
Client-side configurations
Currently, there are no supported options available to configure the client either through the tenant admin, PowerShell, Group Policy Objects or the registry.
Notification settings
There are currently no options available for IT administrators to configure client-side notification settings. All notification options are set by the user. The figure below outlines the default client settings.
Sample PowerShell script - inbound firewall rule
This sample script, which needs to run on client computers in the context of an elevated administrator account, will create a new inbound firewall rule for each user folder found in c:users. When Teams finds this rule, it will prevent the Teams application from prompting users to create firewall rules when the users make their first call from Teams.
-->Tip
Watch the following session to learn about the benefits of the Windows Desktop Client, how to plan for it and how to deploy it: Teams Windows Desktop Client.
To use Microsoft Endpoint Configuration Manager, or Group Policy, or any third-party distribution mechanisms for broad deployment, Microsoft has provided MSI files (both 32-bit and 64-bit) that admins can use for bulk deployment of Teams to select users or computers. Admins can use these files to remotely deploy Teams so that users do not have to manually download the Teams app. When deployed, Teams will auto launch for all users who sign in on that machine. (You can disable auto launch after installing the app. See below.)We recommend that you deploy the package to the computer, so all new users of the machine will also benefit from this deployment.
These are the links to the MSI files:
Entity | 32-bit | 64-bit | ARM64 |
---|---|---|---|
Commercial | 32-bit | 64-bit | ARM64 |
U.S. Government - GCC | 32-bit | 64-bit | ARM64 |
U.S. Government - GCC High | 32-bit | 64-bit | ARM64 |
U.S. Government - DoD | 32-bit | 64-bit | ARM64 |
To ensure a successful deployment, be aware of the following:
Install the 64-bit version of Teams on 64-bit operating systems. If you try to install the 64-bit version of Teams on a 32-bit operating system, the installation won't be successful and currently you won't receive an error message.
If the customer tenant is on the GCCH or DoD clouds, the customer should set the initial endpoint in the registry by adding the CloudType value to the HKEY_CURRENT_USERSOFTWAREPoliciesMicrosoftOffice16.0Teams key in the registry. The type for CloudType is DWORD and values are (0 = Unset, 1 = commercial, 2 = GCC, 3 = GCCH, 4 = DOD). Setting the endpoint with the registry key restricts Teams to connecting to the correct cloud endpoint for pre-sign-in connectivity with Teams.
Teams can also be included with a deployment of Microsoft 365 Apps for enterprise. For more information, see Deploy Microsoft Teams with Microsoft 365 Apps for enterprise.
To learn more about Microsoft Endpoint Configuration Manager, see What is Configuration Manager?
Deployment procedure (recommended)
- Retrieve the latest package.
- Use the defaults prepopulated by the MSI.
- Deploy to computers when possible.
How the Microsoft Teams MSI package works
PC installation
The Teams MSI will place an installer in Program Files. Whenever a user signs into a new Windows User Profile, the installer will be launched and a copy of the Teams app will be installed in that user's AppData
folder. If a user already has the Teams app installed in the AppData
folder, the MSI installer will skip the process for that user.
Do not use the MSI to deploy updates, because the client will auto update when it detects a new version is available from the service. To re-deploy the latest installer use the process of redeploying MSI described below. If you deploy an older version of the MSI package, the client will auto-update (except in VDI environments) when possible for the user. If a very old version gets deployed, the MSI will trigger an app update before the user is able to use Teams.
Important
The default location is C:Program Files (x86)Teams Installer on 64-bit operating systems and C:Program FilesTeams Installer on 32-bit operating systems.We don't recommended that you change the default install locations, as this could break the update flow. Having too old a version will eventually block users fromaccessing the service.
Target computer requirements
- .NET framework 4.5 or later
- Windows 8.1 or later
- Windows Server 2012 R2 or later
- 3 GB of disk space for each user profile (recommended)
VDI installation
For complete guidance on how to deploy the Teams desktop app on VDI, see Teams for Virtualized Desktop Infrastructure.
Clean up and redeployment procedure
If a user uninstalls Teams from their user profile, the MSI installer will track that the user has uninstalled the Teams app and no longer install Teams for that user profile. To redeploy Teams for this user on a particular computer where it was uninstalled, do the following:
Important
The next steps contain information about how to modify the registry. Make sure that you back up the registry before you modify it and that you know how to restore the registry if a problem occurs. For more information about how to back up, restore, and modify the registry, see Windows registry information for advanced users.
- Uninstall the Teams app installed for every user profile. For more information, see Uninstall Microsoft Teams.
- Delete the directory recursively under
%localappdata%MicrosoftTeams
. - Delete the
HKEY_CURRENT_USERSoftwareMicrosoftOfficeTeamsPreventInstallationFromMsi
registry value. - Redeploy the MSI package to that particular computer.
Tip
You can also use our Teams deployment clean up script to complete steps 1 and 2.
Prevent Teams from starting automatically after installation
The default behavior of the MSI is to install the Teams app as soon as a user signs in and then automatically start Teams. If you don't want Teams to start automatically for users after it's installed, you can use Group Policy to set a policy setting or disable auto launch for the MSI installer.
Use Group Policy (recommended)
Enable the Prevent Microsoft Teams from starting automatically after installation Group Policy setting. You can find this policy setting in User ConfigurationPoliciesAdministrative TemplatesMicrosoft Teams. This is the recommended method because you can turn off or turn on the policy setting according to your organization's needs.
Download Microsoft Teams App
When you enable this policy setting before Teams is installed, Teams doesn't start automatically when users log in to Windows. After a user signs in to Teams for the first time, Teams starts automatically the next time the user logs in.
To learn more, see Use Group Policy to prevent Teams from starting automatically after installation.
Caution
If you've already deployed Teams and want to set this policy to disable Teams autostart, first set the Group Policy setting to the value you want, and then run the Teams autostart reset script on a per-user basis.
Disable auto launch for the MSI installer
You can disable auto launch for the MSI installer by using the OPTIONS='noAutoStart=true' parameter as follows.
For the 32-bit version:
For the 64-bit version:
When a user logs in to Windows, Teams is installed with the MSI and a shortcut to start Teams is added to the user's desktop. Teams won't start until the user manually starts Teams. After the user manually starts Teams, Teams automatically starts whenever the user logs in.
Note that these examples also use the ALLUSERS=1 parameter. When you set this parameter, Teams Machine-Wide Installer appears in Programs and Features in Control Panel and in Apps & features in Windows Settings for all users of the computer. All users can then uninstall Teams if they have admin credentials on the computer.
Note
If you run the MSI manually, be sure to run it with elevated permissions. Even if you run it as an administrator, without running it with elevated permissions, the installer won't be able to configure the option to disable auto start.