← Back to docs
🔄
Troubleshooting

App won't update (auto-update stuck)

Last verified: October 2026

How updates usually work

When a new version is ready, FocusDragon downloads it quietly. It installs the next time you quit the app, so the following launch is already up to date. An update banner only appears if you have not quit for about a week.

Symptoms

Your version stays old even though a newer release is out. Check for Updates does nothing, errors out, or never finds a newer build.

Likely causes

  • You have not quit FocusDragon since the download finished — quit once (Cmd+Q) and reopen
  • The auto-update configuration is missing from the app's Info.plist (happens with builds not produced by the proper release pipeline)
  • Network is blocking www.focusdragon.app
  • The bundle on disk is corrupt or only partially written

Step-by-step fix

  • 1. Click the FocusDragon menu → Check for Updates. Wait for the dialog.
  • 2. If an update downloaded, quit FocusDragon completely and reopen it.
  • 3. If it says "You're up to date" but you know you aren't, quit and relaunch, then try again.
  • 4. If the update check still doesn't surface a newer build, redownload the DMG directly from focusdragon.app.
After any FocusDragon update, Safari often turns the FocusDragon extension off. Turn it back on once — see "Safari closes after an update".

Last resort

Download the latest DMG directly from focusdragon.app, quit FocusDragon, drag the new app into /Applications (replacing the old one), and relaunch. Your blocks, settings, and account stay intact — they live outside the bundle.

Still stuck? Contact support at focusdragon.app/contact with your current version (FocusDragon → About).

Still stuck? Contact support