sodcalculator

10 Tech How-To

Fix Discord Installation Failed Error

Guide 10-12157 · Updated · Step by step

If you see the “Installation has failed� error in Discord, it usually means the installer cannot write to its own folder or a required file is locked, and the fix is to clear the Discord cache folders and reinstall with administrator rights. Below are the exact steps to resolve it, plus the reasons it happens and how to avoid it in the future.

What Causes the Installation Failed Error

Discord’s Windows installer is a small bootstrap that downloads the full application and places it in %LocalAppData%\Discord. The error appears when that process is interrupted. Common triggers include:

  • Another Discord process (or a leftover updater) is still running in the background.
  • Antivirus or Windows Defender quarantines a newly downloaded file mid-install.
  • The %LocalAppData%\Discord folder is corrupted or has permission restrictions.
  • A previous update left a locked Update.exe or Discord.exe file.
  • The installer cannot reach Discord’s CDN due to a VPN, proxy, or firewall rule.

Because the error message rarely says which step failed, the fastest approach is to remove all traces of the old installation and start fresh.

Step-by-Step Fix

  1. Close Discord completely. Right-click the Discord icon in the system tray (near the clock) and select Quit Discord. Then open Task Manager (Ctrl+Shift+Esc) and end any process named Discord.exe, Update.exe, or DiscordPTB.exe.
  2. Delete the Discord folders. Press Win+R, type %LocalAppData%, and press Enter. Delete the Discord folder (and DiscordPTB or DiscordCanary if you used those versions). Also delete %AppData%\discord — this holds settings and cache, but note that it will sign you out of all servers.
  3. Clear the installer cache. Open %LocalAppData%\SquirrelTemp if it exists and delete its contents. Discord uses Squirrel for updates, and a stuck temp file is a frequent culprit.
  4. Reinstall as administrator. Download the latest DiscordSetup.exe from the official Discord website. Right-click the file and choose Run as administrator. This ensures the installer can write to protected folders.
  5. Temporarily disable antivirus. If the error persists, pause Windows Defender real-time protection (Settings → Privacy & Security → Windows Security → Virus & threat protection) and run the installer again. Re-enable protection immediately after.
  6. Check your network. If you use a VPN or proxy, disconnect it and try again. Also flush DNS by opening Command Prompt as admin and typing ipconfig /flushdns.

After a successful install, Discord will update itself automatically. If the error returns later, repeat steps 1–3 — it’s usually a leftover update file.

Why Deleting the AppData Folder Works

Discord stores its core files in %LocalAppData%\Discord and user settings in %AppData%\discord. When an update fails, the installer often leaves a partial file that the next run tries to overwrite. Because the file is marked “in use� by a background process, the installer aborts with the generic “Installation has failed� message. Deleting both folders gives you a clean slate. The trade-off is that you’ll need to re-scan the QR code or log in again, and server-specific settings (like notification preferences) will reset to defaults.

Common Misconception: It’s Not a Server Problem

Many users assume the error is caused by Discord’s servers being down. That is rarely the case. The installer downloads from Discord’s CDN, which is separate from the chat servers. Even if Discord’s status page shows an outage, the installer usually still works. The error is almost always local. If you see “Installation has failed� immediately after clicking the setup file, before any progress bar, that points to a permissions issue or antivirus block — not a network outage.

Alternative Fixes for Persistent Cases

  • Use the Windows Installer Troubleshooter. Microsoft offers a free tool that resets Windows Installer registry entries. Run it and then retry Discord setup.
  • Create a new Windows user account. If your account’s permissions are corrupted, a temporary admin account can install Discord and then you can copy the folder back.
  • Install via the Microsoft Store version. The Store version uses a different installer and can bypass the Squirrel issue. Note that it updates separately and may lack some features like overlay in certain games.
  • Check disk space and file system. Ensure you have at least 500 MB free on the drive where %LocalAppData% resides. Run chkdsk /f on that drive if you suspect corruption.

How to Prevent the Error in the Future

  • Always quit Discord from the system tray, not just by closing the window.
  • Keep Windows and your antivirus up to date to avoid compatibility issues.
  • If you use a VPN, add Discord’s domains to the split-tunnel exclusion list.
  • Do not run Discord from a network drive or a folder with restricted write permissions.

Frequently Asked Questions

Will I lose my messages if I delete the AppData folder? No. Messages are stored on Discord’s servers. You only lose local cache (like images) and settings. You’ll need to log in again.

Can I fix this without reinstalling? Sometimes. Try closing Discord and deleting only the SquirrelTemp folder, then run Update.exe from the Discord folder. If that doesn’t work, a full reinstall is the reliable path.

Why does the error happen after a Windows update? Windows updates can change file permissions or leave the system in a state where the installer can’t write to %LocalAppData%. The delete-and-reinstall method usually resolves it.

Is the Microsoft Store version a good alternative? It works for most users, but it updates via the Store, which can lag behind the direct version. If you need the newest features immediately, the direct version is better.

What if I’m on macOS and get a similar error? The steps differ. On macOS, delete ~/Library/Application Support/discord and ~/Library/Caches/com.hnc.Discord, then re-download the .dmg file. The Windows-specific folder names don’t apply.

Does the error mean my account is banned? No. The error is purely local and has nothing to do with your account status.

Related

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 →