When an update fails

Deventry updates in steps, so you can tell where one went wrong. Before it closes, a failure leaves everything as it was. After it closes, it goes back to the old version when it can.

Before Deventry closes

The package fails a check, Windows refuses it, or the macOS helper can’t start. Your tabs come straight back, and the update card says why, in a box under the notes. Nothing else happens.

If the package is fine but couldn’t be installed this way, the card offers a way to install it yourself:

  • Open the installer on Windows opens the package in App Installer.
  • Open the disk image on macOS opens the .dmg.

Moving Deventry to Applications

macOS runs an app opened from Downloads from a temporary, read-only copy, and that copy can’t be updated. The card asks you to move Deventry to Applications, or to install by hand.

  1. Quit Deventry.
  2. Drag Deventry.app to your Applications folder.
  3. Open it from Applications.

After Deventry closes

  • macOS, the new version doesn’t start. The helper stops it, puts the old app back and starts that. The old app takes the tabs back from the snapshot, which is still there, and says the update didn’t finish.
  • Windows, the new version doesn’t start. The snapshot waits for a day. The next time you start Deventry within that day, it takes your tabs from the snapshot, even without a restart request, and says whether the update installed.

Installing by hand

  1. Download the package for your system from the Downloads page.
  2. Quit Deventry.
  3. On Windows, open the .msix and follow App Installer’s prompts. It replaces your installed Deventry. On macOS, open the .dmg and drag Deventry.app onto the Applications link, replacing the one there.
  4. Start Deventry.

Your settings, saved tabs and history are in Deventry’s own folders, so they’re still there. Pinned tabs come back, and so do unpinned ones when Settings → General → Also restore unpinned tabs when Deventry starts is on: see Closing and restoring.

Other causes

  • No package for your computer. This release has no package for this computer yet. See its release page. The release may still be uploading, or may not cover your system. Check the Downloads page.
  • No checksum. GitHub published no checksum for this release’s package, so Deventry can’t check it. Download it from the release page and install it by hand.
  • A copy that can’t update itself. Install the new version by hand.
  • Upgrading from 0.1.0. 0.1.0 can’t install later versions at all: see Deventry’s updates.

If an update keeps failing, Reporting an issue says what to include.

See also

Back to top

Deventry is made by dotBunny under the MIT license. Privacy policy

Claude and Claude Code are trademarks of Anthropic, PBC. Godot and the Godot logo are trademarks of the Godot Foundation; the logo is by Andrea Calabró, under CC BY 4.0. Unity is a trademark or registered trademark of Unity Technologies or its affiliates in the U.S. and elsewhere. Unreal®, Unreal Engine®, and the Unreal Engine® logo are trademarks or registered trademarks of Epic Games, Inc. in the United States of America and elsewhere. Other brands or product names are the trademarks of their respective owners. The logo is used with Epic's permission. Perforce, P4V and the Perforce logo are trademarks of Perforce Software, Inc. or one of its affiliates; the logo is used with Perforce's permission. Deventry isn't sponsored by, affiliated with or endorsed by any of them. Other names are trademarks of their owners.

Edit this page on GitHub

This site uses Just the Docs, a documentation theme for Jekyll.