New Teams - Errors Encountered When Installing New Teams

Overview

Installing New Microsoft Teams can be problematic. This is due to group policies that may be in place, registry key settings, and/or Teams cached information.

Hardware Requirements

If New Teams is having issues crashing, starting, being slow, etc., refer to Microsoft's documentation on Hardware requirements for Microsoft Teams. Some older or lower-end computers may not meet, or may just barely meet, these requirements which can result in a degraded Teams experience for customers.

Users with computers that are unable to properly run New Teams will be limited using the web version of teams at https://teams.microsoft.com/.

Teams Cache

Instructions for clearing Teams Cache is available in our knowledge base. The instructions given cover deleting the settings.json file within the Teams cache directory. In some instances, deleting all files from that directory may be needed to correct the issue. This level of troubleshooting can usually be performed by an end user without administrator permissions.

Registry Key

Windows computers may have a registry keys set that will prevent the installation of New Teams. If the following keys are present, make sure they are set to the values given here. If these keys are NOT present, DO NOT add them.

• BlockNonAdminUserInstall
  • Should be set to 0
• AllowAllTrustedApps
  • Should be set to 1
• AllowDevelopmentWithoutDevLicense
  • Should be set to 1

Their potential locations for the above keys:

Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Appx

Support documentation regarding these registry keys and their values is available on the Microsoft Learn website.

Group Policy

Group policies may be in place that control the values of the registry keys mentioned above. A set of scripts are available in the TAMU GitHub repository that will help workstation administrators determine if they have group policies in place that are preventing installation, change the settings temporarily to facilitate installation, install New Teams, and reset the registry keys afterward.