If Discord won’t open, check status, end stuck tasks, clear cache, disable proxies, update, then reinstall if files are corrupt.
When the desktop or mobile client refuses to launch, the cause usually sits in one of five buckets: a service outage, a stuck background task, bad cache, blocked network settings, or a broken install. This guide walks you through quick checks first, then deeper fixes for Windows, macOS, Android, and iOS. Start at the top and move down until the app launches again.
Quick Checks Before You Troubleshoot
These small moves solve a large share of launch hiccups. Run them in order; they’re safe and take only a few minutes.
| Symptom | Likely Cause | Fast Fix |
|---|---|---|
| Button does nothing or splash screen hangs | Background process stuck | Quit all Discord tasks in Task Manager/Activity Monitor, relaunch |
| Spinner/“Connecting” forever | Outage or blocked connection | Check the Discord status page; if green, review proxy/firewall |
| Opens once, then fails later | Corrupt cache | Clear cache folders (steps below), sign in again |
| Instant crash on launch | Damaged files | Remove app, delete residual folders, install fresh |
| Stuck on “Checking for updates” | Updater blocked | Disable proxies, allow through firewall, try manual installer |
Discord App Not Opening On Windows Or Mac — Fixes That Work
Desktop is where launch failures show up most. The steps below cover both platforms, with Windows first, then macOS. After each step, try to open the app again.
1) Confirm Service Health
Open the official service status dashboard. If the API or Gateway shows an incident, wait for recovery. Widespread outages are rare, but they do happen, and local tweaks won’t help until the service is stable again.
2) Kill Stuck Background Tasks
Windows
- Press
Ctrl+Shift+Escto open Task Manager. - On the Processes tab, right-click any Discord entries → End task.
- Check the Details tab for leftover
Discord.exeand end those as well. - Launch the app from the Start menu.
macOS
- Open Activity Monitor, search for Discord.
- Select each process → click the stop (✕) button → Quit, then Force Quit if needed.
- Launch the app from Applications or Spotlight.
3) Clear Cache And Temp Files
Old cache can lock the client into a bad state. Clearing it forces a clean start. You’ll sign in again, but no servers or messages are lost.
Windows
- Close the app completely (see step 2).
- Press
Win+R→ paste%AppData%\Discord→ delete theCache,Code Cache, andGPUCachefolders. - Press
Win+R→ paste%LocalAppData%\Discord→ remove any leftover updater temp folders.
macOS
- Quit the app.
- In Finder, press
Shift+Cmd+G→ go to~/Library/Application Support/discord/. - Delete
Cache,Code Cache, andGPUCache. Empty Trash.
4) Turn Off Proxies And Let The App Through The Firewall
Proxies and strict firewalls can stop the client from reaching the Gateway. The official guide for “connecting screen” loops recommends disabling proxies and confirming the firewall rules.
- Windows proxy: Control Panel → Internet Options → Connections → LAN settings → uncheck “Use a proxy server”.
- macOS proxy: System Settings → Network → your network → Details → Proxies → make sure nothing is enabled.
- Firewall: allow the app in Windows Security → Firewall & network protection → Allow an app; on macOS, add it under System Settings → Network → Firewall → Options.
If you’re seeing an endless “Connecting” loop, the official help page lists these exact checks and is a handy reference while you work.
5) Run The Installer Fresh
If the launcher crashes or hangs every time, the install might be damaged. The Windows help article for corrupt installs advises a full removal and re-install. Do this cleanly so the updater can rebuild files.
Windows clean reinstall
- Uninstall Discord from Settings → Apps.
- Delete residual folders:
%AppData%\Discord%LocalAppData%\Discord
- Reboot.
- Download the latest installer from the official site, run it, and sign in.
macOS clean reinstall
- Quit the app and move it to Trash from Applications.
- Remove
~/Library/Application Support/discord. - Empty Trash, reboot, install a fresh copy, and sign in.
6) Reset Network Bits That Commonly Interfere
If the app only fails on your machine while others on the same network are fine, reset local networking.
Windows
- Open Command Prompt as admin.
- Run, in order:
ipconfig /flushdns,netsh winsock reset,netsh int ip reset, then restart the PC.
macOS
- Toggle Wi-Fi off/on, remove and re-add the network, or renew DHCP lease in Network settings.
- If you use a VPN, quit it and try again.
7) Try These Quick Toggles
- Run as administrator (Windows): right-click the shortcut → Run as administrator.
- Turn off compatibility mode: right-click shortcut → Properties → Compatibility → uncheck all boxes.
- Disable overlay in other apps: GPU overlays sometimes clash; close game launchers and GPU panels, then launch again.
Fixes For Phones And Tablets
On mobile, launch trouble usually ties back to cache data, storage, or a stale build. Work through these steps in order.
Android
- Force stop: Settings → Apps → Discord → Force stop.
- Clear cache: Settings → Apps → Discord → Storage → Clear cache. Avoid clearing data until a cache clear fails.
- Update: Open Play Store, update the app.
- Reinstall: Uninstall, reboot the phone, install fresh, sign in.
iPhone/iPad
- Offload the app: Settings → General → iPhone Storage → Discord → Offload App, then Reinstall App.
- Update: Open App Store, update the app.
- Reinstall: If offload doesn’t help, delete the app, reboot, install fresh, sign in.
Deeper Dives For Persistent Desktop Problems
Still stuck? The moves below take a few more minutes but knock out tough cases tied to drivers, permissions, and lingering updater snags.
Rebuild GPU Cache And Turn Off Hardware Acceleration (Once You Get In)
Bad GPU cache can block rendering at launch. Clearing the cache as shown earlier helps. If you manage to open the app once, head to Settings → Advanced and turn off hardware acceleration, then restart the client.
Whitelist The App In Security Tools
Some endpoint suites quarantine updater temp files. Add the install path to your security software’s allow-list. On Windows Defender, add an exclusion under Virus & threat protection settings → Exclusions.
Create A Fresh Local Profile (Windows)
User-profile corruption can keep the app from reading its config path. Create a new local account, sign in, and try launching. If it works there, migrate slowly or reset the profile folders listed earlier.
Run A System File Check (Windows)
- Open Command Prompt as admin.
- Run
sfc /scannowand wait for completion. - If it finds issues, run
DISM /Online /Cleanup-Image /RestoreHealth, then run SFC again and reboot.
Where The App Stores Its Cache (So You Can Clean It Fast)
Here’s a quick locator table you can bookmark. Use it when the client starts acting up after an update or a crash.
| Platform | Cache Path | What To Delete |
|---|---|---|
| Windows | %AppData%\Discord |
Cache, Code Cache, GPUCache |
| macOS | ~/Library/Application Support/discord/ |
Cache, Code Cache, GPUCache |
| Android | Settings → Apps → Discord → Storage | Tap Clear cache |
When You See A “Corrupt Installation” Banner
If you run into a corrupt-install banner on Windows, follow the official steps: uninstall the client, remove the two AppData folders listed above, reboot, then install the newest build from the official site. This clears broken updater files and stale modules that block a clean launch.
“Connecting” Or “Awaiting Endpoint” Forever
That loop points to networking. Confirm the status page shows green, set system date/time to automatic, disable any proxy or VPN, and allow the client through your firewall. Those moves match the official guidance for connection loops and prevent the app from getting stuck at the first handshake.
Make Launch Success Stick
Once the app opens again, keep it stable with these simple habits:
- Leave proxies and forced DNS off unless you need them for work or school.
- Update the client and your OS on a regular schedule.
- If the app hangs after a crash, clear cache first before reinstalling.
- Bookmark the status page and check it whenever you see widespread chatter about downtime.
What To Do If Nothing Works
If you’ve cleared cache, reinstalled clean, checked the status page, and verified networking, it’s time to reach out to support. Include a short timeline, your OS version, and any error text from the developer console. On desktop, open the console with Ctrl+Shift+I (Windows) or Option+Cmd+I (Mac) after the window appears; copy any errors you see and attach them to your ticket. The more precise your notes, the faster the fix.
Printable Fix Path You Can Follow
- Open the status dashboard; if there’s an incident, wait.
- End all Discord tasks; relaunch.
- Clear cache folders; relaunch.
- Disable proxies and allow through the firewall.
- Reinstall clean if launches keep failing.
- Reset local network bits; try again.
- Run SFC/DISM on Windows or offload/reinstall on iOS.
- Gather console logs and contact support with details.
Why These Steps Solve The Launch Problem
Launch failures usually boil down to one of three mechanics: the app can’t reach its servers, the local install can’t start a clean render, or the updater left broken files behind. Checking service health rules out global issues fast. Ending background tasks clears stale locks. Cache removal wipes broken state and forces fresh assets. Proxy and firewall checks reopen the path to the Gateway. A clean reinstall rebuilds the app folder. If a system file blocks the process on Windows, SFC and DISM catch and repair it. Put together, this sequence gives you a straight path from quick wins to full reset, with no fluff and no risky tweaks.
