Skip to content

Backup and Restore a Space

Overview

This guide explains how to create an encrypted Space backup (.usbk) and restore it into another Safe.

Use this primarily for controlled data migration between Safes. UnoLock Safe storage is already highly redundant, and password-protected backups reduce your security posture if the password is weak.

Before You Start

  • Use a strong, unique passphrase for backup encryption.
  • Perform backup and restore in a trusted environment.
  • Ensure you have local archive files (.ulf) available if the Space contains local archives.
  • Decide whether to include wallets. Wallet export requires WebAuthn verification.

Create a Space Backup

  1. Open Configuration.
  2. Open Spaces.
  3. On the target Space, click Backup.
  4. Read the warning and continue only if needed.
  5. Enter and confirm your backup password.
  6. Choose whether to include wallets.
  7. If prompted, select local archive files (.ulf) for that Space.
  8. Choose where to save the .usbk file.
  9. Wait for completion in the backup progress modal.

Restore a Space Backup

  1. Open Configuration.
  2. Open Spaces.
  3. Click Restore.
  4. Select the .usbk file.
  5. Enter the backup password.
  6. Wait for completion in the restore progress modal.
  7. A restored Space is created with the suffix (Restored).

What Gets Restored

  • Records and labels from the source Space.
  • Cloud, message, and local archives that are present in the backup.
  • Optional wallet secrets if wallet inclusion was selected during backup.

Archive ID Remapping

Restored archives receive new archive IDs in the destination Safe. Record attachments are automatically remapped so notes still point to the correct restored files.

Local Archive Notes

  • Local archives are included only when matching .ulf files are provided during backup.
  • Missing required local files block backup in strict mode.
  • If a local file is not available at backup time, that archive is skipped.

Wallet Notes

  • Wallet inclusion is optional.
  • Wallet secret parts are decrypted in one batched WebAuthn-assisted request during backup.
  • On restore, wallet secrets are re-encrypted using the destination Safe’s WebAuthn-protected encryption flow.

Security Warnings

  • Backup files are encrypted, but still vulnerable to offline password guessing if a weak password is used.
  • Do not store backup files in untrusted locations.
  • Do not treat backups as a replacement for normal Safe key hygiene (multiple keys, LockoutGuard, and operational controls).

Troubleshooting

Restore fails with password/corruption error

  • Verify password exactly.
  • Verify backup file integrity and full file transfer.

Some files are missing after restore

  • Check the skipped archive count in completion details.
  • Re-run backup with all required local .ulf files selected.

Wallets did not restore as expected

  • Confirm wallet inclusion was selected during backup.
  • Complete required WebAuthn verification prompts during backup and restore.