All guides
Desktop troubleshooting

A 10-minute checklist for a desktop app that will not start

Work from the cheapest, safest checks to the changes that need a rollback plan.

A failed launch rarely means you should reinstall immediately. Start by collecting evidence and changing one thing at a time.

1. Confirm the failure

Restart the app once and write down the exact message. If there is no message, note whether the process appears briefly in the system task list. This separates a launch failure from a window that opened off-screen.

2. Check the smallest dependencies

Confirm that the device has free disk space, the system clock is correct, and the app's required network is reachable. Open another app that uses the same connection before changing firewall settings.

3. Try a clean user state

Back up the app's configuration folder, then rename it instead of deleting it. Launch again. If the app opens, restore only the files you need so a damaged preference does not return.

4. Read the operating-system log

Look for an entry at the exact failure time. Record the failing module and error code. Search for that pair together; generic searches such as “app broken” usually lead to unrelated fixes.

5. Reinstall only after preserving data

Export profiles, license information and local projects first. Use the vendor's official installer and confirm the version and architecture match your system.

Stop and escalate when

Stop if the suggested fix asks you to disable endpoint protection permanently, download an unofficial binary, or edit system-wide settings without a rollback path.

STILL STUCK?

Send us the missing detail.

Useful feedback improves the guide for the next reader.

Contact the editor