No ROMs / no copyrighted assets
This independent guide does not host or link to game files. Use your own legally obtained copy.
Symptoms
- App closes immediately on launch.
- Window flashes and disappears.
- Permission denied dialog.
- OS antivirus or Gatekeeper blocks the binary.
Likely causes
- OS security flagged the binary on first run.
- Required runtime libraries missing.
- Your copy's SHA-1 doesn't match a supported build.
- Insufficient file permissions on the install folder.
First safe fixes
Try in this order
- Confirm your supported version on /supported-versions.
- Run Dusk from a terminal so the first error is visible.
- Re-download Dusk cleanly from the official source.
- Update GPU drivers and platform runtime libraries.
- Allow the binary in your OS's security settings.
Platform-specific notes
- Windows: SmartScreen blocks unrecognized apps; click 'More info' → 'Run anyway' if from official source.
- macOS: System Settings → Privacy & Security → 'Open Anyway' next to the Dusk message.
- Linux: Run from terminal to see missing-library errors; install Vulkan / SDL2.
- Steam Deck: Verify the launch options string in Gaming Mode is empty unless instructed otherwise.
- Android: Grant storage and media permissions; uninstall and reinstall if it won't open at all.
Still stuck?
Open the troubleshooting wizard for a different symptom or platform combination. If everything checks out and the issue persists, file a bug at the official Dusk project.
Reference slug: wont-launch