Troubleshoot classic Microsoft Teams installation and update issues on Windows
This article provides guidance for how to diagnose and troubleshoot installation and update issues for the Teams desktop client app running on Windows. For additional troubleshooting information, see Teams troubleshooting.
This article applies only to classic Microsoft Teams. For new Teams, see: Troubleshooting installation issues in the new Teams client
Check whether Teams is updated successfully
Follow these steps to check whether a Teams update is successfully installed.
- In Teams, select the ellipsis (...) next to your profile picture, and then click About > Version. A banner will appear that shows your current Teams version and when it was last updated. For example You have Microsoft Teams Version 1.5.00.3806 (64-bit)-E. It was last updated on 2/16/2022.
- Open the ellipsis menu again and click Check for updates.
- Wait for the banner at the top of the app to indicate that a "refresh" of Teams is needed. The link should be shown about a minute later as this process downloads the new version of Teams. The banner also lets you know if you’re already running the latest version in which case, no update is necessary.
- Click the refresh link in the banner.
- Wait until Teams restarts, and then repeat step 1 to see whether the app is updated.
If you see a failure message or if the version number is the same as in step 4, the update process failed.
Troubleshoot installation and update issues
Troubleshoot installation issues
When Teams is installed, the Teams installer logs the sequence of events to
%LocalAppData%\SquirrelTemp\SquirrelSetup.log. The first thing to look for is an error message or a call stack near the end of the log. Note that call stacks at the beginning of the log may not mean that an installation issue exists. It can be easier to compare your log against the log from a successful installation (even on another machine) to see what's expected.
%LocalAppData%\SquirrelTemp\SquirrelSetup.log doesn't indicate the cause or if you need more information to troubleshoot the issue, see Collect and analyze application and system logs.
Troubleshoot update issues
When Teams is successfully installed, the log location switches from
%LocalAppData%\Microsoft\Teams\SquirrelSetup.log. Another log file of interest is
%LocalAppData%\Microsoft\Teams\SquirrelSetup.logfile is written by
Update.exe, which is an executable that services the Teams app.
%AppData%\Microsoft\Teams\logs.txtfile is used by the Teams app (specifically
Teams.exe) to record significant application events. It will likely contain failure information.
These log files contain personally identifiable information (PII) so they're not sent to Microsoft.
Teams can automatically start the update process (depending on the policy) or users can manually check for updates by going to the ellipsis (...) menu next to their profile picture and selecting Check for updates. Both methods use the following sequence of events.
- Check for updates. Teams makes a web request and includes the current app version and deployment ring information. The goal of this step is to get the download link. A failure at this step is logged in
- Download update. Teams downloads the update by using the download link obtained from step 1. When the download is complete, Teams calls
Update.exeto stage the download. A download failure is also logged in
- Stage the update. The downloaded content is verified and unpacked into an intermediate folder,
%LocalAppData%\Microsoft\Teams\stage), which is done by
Update.exe. Failures at this step are logged in
- Install the update. There are multiple ways to start Teams. The system automatically starts Teams when a user logs in or you can start Teams through a shortcut. In this step,
Update.exechecks for the presence of the staging folder, verifies the content again, and performs file operations to un-stage the app. The old application folder in
%LocalAppData%\Microsoft\Teams\currentis backed up to
%LocalAppData%\Microsoft\Teams\previousand the stage folder is renamed to
current. Failures at this step are logged in
%AppData%\Microsoft\Teams\logs.txt don't contain sufficient information to determine the underlying cause and you need more information to troubleshoot the issue, go to Collect and analyze application and system logs.
Collect and analyze application and system logs
This section describes how to collect and analyze application and system logs to get more comprehensive information to troubleshoot the issue. You'll use Sysinternals tools to complete these steps. To learn more, see Windows Sysinternals.
Download the Sysinternals tools.
Extract the zip file to the
%Temp%folder on your local drive.
Open an elevated command prompt, and then do the following:
Run the following to go to your
cd /d %Temp%
Copy the setup and application logs. Note that depending on the point of failure, some of these logs may not be present.
copy %LocalAppData%\SquirrelTemp\SquirrelSetup.log SquirrelSetup.log copy %AppData%\Microsoft\Teams\logs.txt logs.txt copy %LocalAppData%\Microsoft\Teams\SquirrelSetup.log SquirrelSetup_Teams.log
Run the following to capture the open handles.
handle > handles.txt
Run the following to capture the opened DLLs.
listdlls -v Teams > dlls.txt
Run the following to capture the drivers that are running.
driverquery /v > driverquery.txt
Run the following to capture the access control lists (ACLs) of the Teams folder.
icacls %LocalAppData%\Microsoft\Teams /save icacls.txt /T
Analyze logs (for advanced users)
A failed update can result in unpredictable app behavior. For example, users may be unable to exit Teams, have a stale version of Teams, or can't start Teams. If you experience an issue during an update, the first place to look to find the cause is
%LocalAppData%\SquirrelTemp\SquirrelSetup.log. Here are the different types of update failures, listed from most common to least common, and how to analyze and troubleshoot them using logs.
Unable to exit Teams
As Teams determines that it needs to update itself to a newer version, it downloads and stages the new app, and then waits for an opportunity to restart itself the next time the machine is idle. A common issue during this process is when another process or a file system driver locks up the
Teams.exe process, which prevents
Teams.exe from exiting. As a result, the Teams app can't be replaced by the newly-downloaded and staged app.
- To confirm that is the issue that you're experiencing, quit Teams (right-click Teams on the task bar, and then click Quit). Then, open Task Manager in Windows to see whether an instance of Teams is still running.
- If you’re not on the computer that's having this issue, inspect the
%LocalAppData%\SquirrelTemp\SquirrelSetup.logcollected from the computer that's experiencing this issue and look for a Program: Unable to terminate the process in the log entry.
- To determine what's preventing
Teams.exefrom exiting, look at the
Handles.txtlogs you created in the Collect logs section. These tell you the processes that prevented Teams from exiting.
- Another culprit that can prevent Teams from exiting is the kernel-mode file system filter driver. Use the SysInternals tool, ProcDump, to collect the kernel-mode process dump by running
procdump -mk <pid>, where <pid> is the process ID obtained from Task Manager. You can also inspect the
Driverquery.txtlog file to see the active filter drivers that may interfere with Teams.
- To recover from this state, restart the computer.
Teams creates a number of subfolders and files in the user's profile throughout the installation and update process. Because the app and the updater run as a non-elevated user, read and write permissions must be granted on the following folders:
||Teams installer (for example,
||Teams updater (
||Teams app (
If Teams is denied access because it can't write to a file, another software application may be interfering or a security descriptor entry may be limiting write access to a folder.
- Look for
access deniedevidence in
%AppData%\Microsoft\Teams\logs.txt. Check these files to see whether there was an attempt to write to a file that failed.
Icacls.txtand look for the effective access control entry (ACE) that blocks write operations by a user who is not an admin. Typically, this is in one of the DACL entries. For more information, see the icacls documentation.
In some cases, encryption software can change files in the
%LocalAppData%\Microsoft\Teams folder, which can prevent Teams from starting. This can happen at any time, even when the app isn't being updated. When a file is corrupted, the only way to recover from this state is to uninstall and re-install Teams.
If you can't determine the underlying cause of the issue by using any of these steps, you may want to try a Process Monitor session. Process Monitor is a Sysinternals tool that records access to the registry and file system.