Docs Downloads & Releases macOS Update Procedure

macOS Update Procedure

How to update Bervice on macOS safely while preserving your vault and ensuring compatibility with the latest features.

Before You Update

  • Ensure your recovery phrase or key file is securely backed up and stored offline.
  • Export recent activity logs if you’re troubleshooting an issue.
  • Check the Status Page for active incidents.
  • Review the release notes for any breaking changes.

Standard Update Method (.dmg)

  1. Go to the macOS downloads page.
  2. Download the correct .dmg for your architecture (Universal, ARM64, or x64).
  3. Open the disk image and drag Bervice.app into the Applications folder.
  4. When prompted, replace the existing application.
  5. Launch Bervice from Applications and confirm your vault data is intact.

Portable Build Update (.zip)

  1. Download the latest portable .zip from the macOS downloads page.
  2. Unzip the file into a new folder.
  3. Copy over your existing vault/ and config.json files from the old folder.
  4. Launch the new Bervice.app to verify everything works before deleting the old version.

Silent Update (IT/Admin)

For MDM or automated macOS deployments:

sudo ditto /path/to/Bervice.app /Applications/Bervice.app

This replaces the app in place without prompting and keeps user vault data intact.

After Updating

  • Go to Bervice → About to confirm the version number.
  • Check that your vault decrypts and all features work as expected.
  • If issues occur, export logs and report a bug.

Rollback Procedure

If you need to revert to a previous version:

  1. Download the desired older version from Archived Releases.
  2. Replace the current application in Applications with the older build.
  3. Launch and confirm vault access.

For maximum security, always verify your download using both the SHA-256 checksum and GPG signature.