Linux Update Procedure

Before You Update

• Back up your recovery phrase or key file and store it securely offline.
• Export any recent logs if you are updating to troubleshoot an issue.
• Check the Status Page for any active incidents.
• Review the release notes for potential breaking changes.

Update by Installation Type

AppImage

1. Download the latest .AppImage from the Linux downloads page.
2. Make it executable:

   chmod +x bervice-vX.Y.Z-linux.AppImage

3. Replace your old AppImage file with the new one, or keep multiple versions in separate directories.
4. Run the updated AppImage — your vault remains intact.

Debian/Ubuntu (.deb)

1. Download the latest .deb package for your architecture (amd64/arm64).
2. Install it:

   sudo apt install ./bervice-vX.Y.Z-amd64.deb

3. The package manager will upgrade in place, preserving your vault.

Fedora/RHEL (.rpm)

1. Download the latest .rpm for your architecture (x86_64/aarch64).
2. Install it:

   sudo dnf install ./bervice-vX.Y.Z-x86_64.rpm

3. The update will preserve your vault and settings.

Tarball (.tar.gz)

1. Download the latest .tar.gz for your architecture.
2. Extract it to a new folder:

   tar -xzf bervice-vX.Y.Z-linux-x64.tar.gz

3. Copy your existing vault/ and config.json into the new directory.
4. Run the new binary (./Bervice) from the extracted folder.

Silent Update (IT/Admin)

For automated deployment in enterprise environments:

sudo apt install -y ./bervice-vX.Y.Z-amd64.deb or sudo dnf install -y ./bervice-vX.Y.Z-x86_64.rpm

These commands update in place without prompts, preserving user vaults.

After Updating

• Check Help → About to confirm the new version.
• Verify that your vault loads and decrypts properly.
• If issues occur, export logs and report them.

Rollback Procedure

If you need to revert to an earlier version:

1. Find the desired older version in the Archived Releases.
2. Uninstall the current version (AppImage users can just delete the file).
3. Install the older build following the same method you originally used.

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