Teams Installation Failed? Here’s the Fix

If Microsoft Teams fails to install on Windows or Mac, the cause is almost always a leftover cache from a previous install, a permissions conflict, or a corrupted installer file. The fix is to fully clear the old Teams data, run the installer as an administrator (on Windows), and if that fails, use the official uninstall/cleanup tool before reinstalling. Below is the complete troubleshooting path, from quick checks to the deep clean that resolves stubborn failures.

Why Teams Installations Fail

Teams is a heavy Electron-based app, and its installer is sensitive to its own previous versions. The most common failure points are:

Leftover cache folders – Teams stores per-user data in %AppData%\Microsoft\Teams (Windows) or ~/Library/Application Support/Microsoft/Teams (Mac). A failed update often leaves these folders locked or corrupted.
Installer conflicts – The new “machine-wide” Teams installer (for Windows) can conflict with the older per-user version if both are partially present.
Permission errors – On Windows, the installer needs to write to Program Files and the registry; a standard user account or aggressive antivirus can block it.
Corrupted download – A partial or interrupted download of the installer file itself will fail with a generic error.
Group Policy or MDM blocks – In enterprise environments, IT policies can prevent installation; this is less common for home users but worth knowing.

Quick Checks Before You Deep Clean

Try these first – they take under a minute and solve a surprising number of cases:

Restart your computer. A reboot clears file locks that the installer may have left behind.
Download a fresh installer. Delete the old TeamsSetup.exe (Windows) or Teams.pkg (Mac) and download again from the official Microsoft Teams page. Do not use a cached copy.
Run as administrator (Windows). Right-click the installer and select Run as administrator. This bypasses many permission issues.
Temporarily disable antivirus. If you have third-party AV, pause it for the install. Windows Defender usually does not interfere, but other suites sometimes do. Re-enable immediately after.

If the install still fails, move to the full cleanup below.

Full Cleanup: The Reliable Fix

This is the method that resolves most persistent failures. It removes every trace of the old Teams installation so the new one starts fresh.

On Windows 10/11

Close Teams completely: right-click the Teams icon in the system tray and choose Quit.
Uninstall Teams via Settings > Apps > Apps & features. Find “Microsoft Teams” and click Uninstall.
Delete the leftover folders. Open File Explorer and navigate to each of these paths, deleting the entire Teams folder if it exists:
- %AppData%\Microsoft\Teams
- %LocalAppData%\Microsoft\Teams
- %LocalAppData%\Microsoft\TeamsMeetingAddin (if present)
- %ProgramData%\Microsoft\Teams (machine-wide installs)
Clear the registry (optional but thorough): press Win+R, type regedit, and navigate to HKEY_CURRENT_USER\Software\Microsoft\Office\Teams. Delete this key if it exists. Warning: editing the registry is risky – only delete the Teams key, and back up the registry first if you are unsure.
Download a fresh installer and run it as administrator.

On macOS

Quit Teams (right-click the Dock icon > Quit).
Delete the app: drag Microsoft Teams from the Applications folder to the Trash.
Delete the support folders. In Finder, press Cmd+Shift+G and go to each path, deleting the Teams folders:
- ~/Library/Application Support/Microsoft/Teams
- ~/Library/Caches/com.microsoft.teams
- ~/Library/Preferences/com.microsoft.teams.plist
- ~/Library/Saved Application State/com.microsoft.teams.savedState
Empty the Trash, then download and install the fresh .pkg file.

Using the Microsoft Support and Recovery Assistant

Microsoft provides a free tool called the Support and Recovery Assistant (SaRA) that automates the cleanup for Teams and other Office apps. It is the easiest option if you are not comfortable manually deleting folders and registry keys.

Go to the official Microsoft Support and Recovery Assistant page (search “Microsoft SaRA”).
Download and run the tool.
Select Teams from the list of applications, then follow the prompts. It will detect and fix installation issues, including clearing cached data.
After it finishes, try installing Teams again.

This tool is particularly helpful for enterprise users, as it can also check for policy blocks.

When the Problem Is Not the Installer

Sometimes Teams installs fine but fails to launch, which can be mistaken for an installation failure. If you see an error like “Teams has stopped working” or the app opens and immediately closes, the issue is usually a corrupted user profile or a conflict with other software.

Clear the Teams cache while keeping the app installed. Close Teams, delete the contents of %AppData%\Microsoft\Teams (Windows) or ~/Library/Application Support/Microsoft/Teams (Mac), then restart Teams. This resets the app without reinstalling.
Check for conflicting apps. Some VPNs, proxy tools, or older Office versions can interfere with Teams. Temporarily disable them to test.
Update your graphics drivers. Teams uses hardware acceleration; outdated drivers can cause crashes on launch. Disable hardware acceleration in Teams settings if the problem persists.

Alternative: Use Teams in the Browser

While you are troubleshooting, you can still access Teams through the web app at teams.microsoft.com. It supports most features – chat, meetings, and file sharing – and requires no installation. This is a practical stopgap, especially if you need to join a meeting urgently. Note that the browser version may lack some advanced features like custom backgrounds or certain admin controls, but it works well for everyday use.

Frequently Asked Questions

Why does Teams keep saying “Installation failed” with no error code?

This generic message usually means the installer could not complete a required step, often due to leftover files or permissions. Follow the full cleanup steps above – deleting the AppData folders and running the installer as administrator resolves most cases. If it still fails, try the SaRA tool.

Do I need to uninstall the old Teams before installing the new one?

Yes. The new Teams (version 2.0) is a different application from the classic Teams, and they can conflict if both are installed. Uninstall the old one and clean its folders before installing the new version. Microsoft is gradually transitioning all users to the new Teams, so this will become less of an issue over time.

Can I install Teams without admin rights?

On Windows, the per-user installer does not require admin rights, but the machine-wide installer does. If you are on a work computer without admin access, contact your IT department. On macOS, you typically need an administrator account to install to the Applications folder.

Will clearing the Teams cache delete my chats and files?

No. The cache only stores temporary data like images, thumbnails, and local settings. Your chats, files, and conversations are stored in the cloud on Microsoft servers. After clearing the cache, Teams will re-download what it needs, and you will see all your history.

Why does Teams install but then fail to update?

Update failures often have the same root causes as installation failures: corrupted cache or permission problems. Run the full cleanup, then reinstall the latest version. If you are on the classic Teams, consider switching to the new Teams, which updates more reliably.

Is it safe to use the browser version while I fix the desktop app?

Yes, the web version is safe and official. It uses the same Microsoft 365 authentication and encryption. Just be aware that some features, like screen sharing in meetings, may have limitations in the browser compared to the desktop app.

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 →