Teams crashes on opening

Dear @Craig Francis,

I understand that Teams crashes immediately when you open it. Then you can’t get into the app at all.

To better assistance, could you please confirm following information:

What device are you using: Windows or macOS?

Does Teams crash before sign-in, during sign-in, or after the window appears?

Do you see any message like “Something went wrong”, an error code, or does it just close silently?

Are other users in your organization affected, or only you?

Can you sign in to Teams on the web successfully (browser)?

In the meantime, please try some steps below:

1/ Please try Teams on the web to see whether the issue persists

2/ Clear Teams cache

Clearing the cache on your device may help. After you clear the cache, please restart Teams.

For Windows:

• Type settings in the search box, and then select the Settings app from the results.
• Select Apps > Installed apps, and then type Microsoft Teams in the search box.
• Locate the New Microsoft Teams app from the results, select the More options button (...) on the right, and then select Advanced options.
• In the Reset section, select Reset.
• Restart Teams.

More detail or for MacOS, please find at: Clear the Teams client cache

3/ If Teams still crashes: Fully uninstall Teams and reinstall

If cache/reset doesn’t help, the next best step is a clean uninstall and reinstall.

For Windows:

• Quit Teams (right‑click Teams icon > Close/Quit).
• Go to Settings > Apps > Installed apps > Type Microsoft Teams in the search box >Select the More options button (...) on the right, and then select Uninstall.
• Restart the PC, then reinstall Teams using your organization’s standard method (Store/Company Portal/installer).

macOS

• Force quit Teams (Option + right‑click Teams in dock > Force Quit).
• Open Applications, move Microsoft Teams to Trash, then reinstall using your organization’s standard method

Please understand that the initial response does not always resolve the issue immediately. However, with your help and more detailed information, we can work together to find a solution.

Your detailed response will help us diagnose and investigate the issue more efficiently. If I misunderstood what you’re looking for, feel free to let me know or share a screenshot. I’d be happy to help further!

Thank you for your cooperation. I'm looking forward for your reply.

If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

Use the following steps to troubleshoot Teams crashing immediately on opening.

1. Fully sign out and restart Teams
   • If possible before it crashes, select the profile picture in the top-right corner and choose Sign out.
   • Let Teams close, then start it again and sign in.
2. Clear the local Teams cache
   • Quit Teams completely (right‑click the Teams icon in the taskbar/notification area and select Quit so no Teams processes remain).
   • On Windows, open File Explorer and go to:
     • %appdata%\Microsoft\Teams
   • Delete all contents of this folder.
   • Restart Teams and sign in again.
3. Completely remove leftover Teams data and reinstall
   • Uninstall Microsoft Teams from Settings → Apps → Installed apps.
   • Open the root of the AppData tree under the user profile and search for any files or folders whose names contain teams (for example under %AppData%, %LocalAppData%, and their subfolders).
   • Delete all remaining Teams‑related folders and files under AppData.
   • Reboot the device.
   • Download and reinstall the latest Teams client and sign in again.
4. Check for WebView2 or GPU‑related failures (if available in logs or admin portal)
   • If an admin can access the Teams client health dashboard and sees Client crash issues with WebView2 exit codes such as RESULT_CODE_GPU_DEAD_ON_ARRIVAL or RESULT_CODE_GPU_EXIT_ON_CONTEXT_LOST, update the device’s GPU drivers and ensure Microsoft Edge WebView2 is installed and not blocked.
   • Make sure antivirus/DLP tools are not blocking Teams or WebView2 processes. For guidance, see the note about including/excluding Teams and WebView2 in security tools.
5. Check for known conflicting software
   • If a VPN or network‑filtering tool such as Astrill is installed and Teams started crashing after an update, temporarily uninstall or disable that software and test Teams again. In reported cases, removing Astrill resolved continuous Teams crashes after an update.
6. If Teams runs in a restricted/virtual environment
   • In environments such as Azure Virtual Desktop with heavy restrictions, if repair/reset does not help, perform a full uninstall and reinstall of Teams as allowed by the environment policies.
7. If the issue persists
   • If all steps above fail and Teams still crashes on launch, collect crash details (for example from Event Viewer or the Teams client health dashboard) and contact Microsoft Support for deeper analysis.

References:

• I can't reconnect to Microsoft Teams
• Resolve Teams "client crash" issues
• Resolve issues when starting the new Teams app
• Teams app on Android crashes right after opening - Microsoft Q&A
• Teams keeps crashing and reloading - Microsoft Q&A
• How to reset Teams desktop app - is crashing while loading the first run - Microsoft Q&A
• Teams continuously crashing in WIN 11 - Microsoft Q&A
• Teams keeps crashing and restarting after updating to version 25332.1210.4188.1171 - Microsoft Q&A
• Teams starts with a white screen