Microsoft Teams Installation Failed: Fixes That Work

If you see “Installation has failed� when trying to install Microsoft Teams, the cause is usually a corrupted installer cache, a stuck background process, or a permissions conflict. The fix typically involves clearing the Teams cache, ending background processes, and reinstalling with the correct installer for your system.

Why Teams Installation Fails

Teams uses a per-machine installer that writes to several protected folders and the Windows registry. When any of those steps is interrupted—by a reboot during install, antivirus software locking files, or a previous incomplete install—Windows rolls back and shows the generic “Installation has failed� message. Another common trigger is running the 32-bit installer on a 64-bit system, or the reverse, which causes a mismatch in the Program Files paths.

Before You Start: Check System Requirements

Teams requires Windows 10 or later (or macOS 10.15 Catalina and newer). It also needs at least 4 GB of RAM and about 2 GB of free disk space. If your system meets those, but the installer still fails, move to the fixes below. If you are installing on a work or school computer, your organization’s policy may block installation—contact your IT admin before spending time on troubleshooting.

Fix 1: Clear the Teams Cache and Old Folders

Leftover files from a previous Teams installation often cause conflicts. Remove them manually:

Press Ctrl+Shift+Esc to open Task Manager.
End any process named Teams or ms-teams.
Press Win+R, type %appdata%\Microsoft\Teams, and delete the entire folder.
Also delete %localappdata%\Microsoft\Teams and %localappdata%\Microsoft\TeamsMeetingAddin if present.
Restart your computer, then try installing again.

If you are using the new Teams (version 2.0), the cache lives in %localappdata%\Packages\MSTeams_8wekyb3d8bbwe. Delete that folder as well if it exists.

Fix 2: Use the Correct Installer

Microsoft offers two main installers: the 64-bit and the 32-bit version. Most modern PCs are 64-bit. To check, go to Settings > System > About and look at “System type.� Download the matching installer from the official Microsoft Teams website, not from a third-party source. If you have Office 365, you can also install Teams from the Office portal, which sometimes bypasses the standalone installer issues.

Fix 3: Run the Installer as Administrator

Teams needs to write to C:\Program Files and the registry. If your user account lacks write permissions, the install fails silently. Right-click the installer file and select Run as administrator. If you are on a work computer, you may need an administrator password—ask your IT department if you don’t have one.

Fix 4: Disable Antivirus Temporarily

Some antivirus programs flag the Teams installer as suspicious because it modifies system files. Temporarily disable your real-time protection, run the installer, then re-enable it. Do not keep it disabled. If the install succeeds with antivirus off, add the Teams installer to the antivirus whitelist to avoid future issues. Windows Defender usually does not cause this problem, but third-party security suites sometimes do.

Fix 5: Repair the .NET Framework and WebView2

Teams relies on the .NET Framework and Microsoft WebView2 runtime. If either is missing or corrupted, the installer may fail. To repair .NET, go to Settings > Apps > Installed apps, find “Microsoft .NET Framework,� and click Modify to run the repair tool. For WebView2, download the latest Evergreen runtime from Microsoft’s official site and install it separately. After both are updated, retry the Teams installation.

Fix 6: Use the Command-Line Installer

If the graphical installer still fails, try the command-line version. Open Command Prompt as administrator and run:

"path\to\Teams_windows_x64.exe" --install

Replace the path with the actual location of your downloaded installer. The --install flag forces a fresh install and sometimes bypasses the GUI’s error handling. You can also use --silent to install without prompts, but only if you want no user interaction.

When to Use the Web Version

If all fixes fail, you can still use Teams in a browser at teams.microsoft.com. The web version supports most features, including chat, meetings, and file sharing. It lacks some desktop-only features like advanced call controls and system tray notifications, but it works well for occasional use. This is a temporary solution until you can resolve the installation issue.

Frequently Asked Questions

Why does Teams say “Installation has failed� on Windows 11?

Windows 11 often blocks installers that were downloaded for an older OS. Make sure you download the latest installer from the official site. Also, check that your Windows 11 is updated to the latest version, as some early builds had compatibility issues with Teams.

Can I install Teams without admin rights?

No, the standard Teams installer requires administrator privileges because it writes to Program Files and the registry. If you don’t have admin rights, use the web version or ask your IT department to install it for you.

How do I uninstall Teams completely before reinstalling?

Go to Settings > Apps > Installed apps, find Microsoft Teams, and click Uninstall. Then delete the cache folders mentioned in Fix 1. If you have the new Teams, also uninstall it from the same list. Restart your PC before reinstalling.

Does the Teams installer work on macOS?

Yes, but the error message is different. On macOS, if the installer fails, try dragging the Teams app to the Trash, then re-downloading from the official site. Also check that your macOS version is supported (10.15 or later).

Why does Teams install but not open?

This is usually a separate issue from installation failure. It often happens when the Teams cache is corrupted or when the app cannot connect to the server. Try clearing the cache (Fix 1) and restarting the app. If that doesn’t work, check your internet connection and firewall settings.

Is there a way to install Teams for all users on a PC?

Yes, the standard installer installs for all users by default. If you need a per-user install, you can use the --user flag in the command-line installer, but this is rarely needed. For enterprise deployments, use the MSI version provided in the Microsoft 365 admin center.

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →