Resolve Teams client launch failures

Important

This article describes a Microsoft Teams feature that hasn't yet been released. It's been announced, and it's coming soon. If you're an admin, you can find out when this feature will be released in the Message Center (in the Microsoft 365 admin center). For more information, see Teams client health and Monitor Teams client updates.

When a user in your organization tries to start the Teams app on their device, a blank window opens and then disappears immediately. This issue is categorized as a Launch failure in the Teams client health dashboard.

As an administrator, you can check the Insight column on the Issues tab to find a potential cause of the launch failure. This article lists all the insights for Teams client launch failures and provides resolutions for them. If the issue persists after you perform the resolution, contact Microsoft Support for more assistance.

Unable to navigate to Teams endpoint

To fix the issue, review and update your network configuration. Make sure that a firewall or proxy settings don't block the Teams client access to Teams endpoints.

Timed out waiting for Teams endpoint

To fix the issue, review and update your network configuration. Make sure that a firewall or proxy settings don't block the Teams client access to Teams endpoints. Also, make sure that all Teams-related network requests are allowed in your environment.

Teams application contains a script error

To fix the issue, ask the affected user to sign out of the Teams app and then sign back in.

Unsupported OS version

To fix the issue, update the operating system on the affected device to a supported version of Windows or macOS.