Skip to content

Moving to Another Computer

cuban8IO edited this page Nov 9, 2026 · 1 revision

Tools → Export settings… writes everything BorgStudio knows into one .borgstudio file; Tools → Import settings… reads it on the other computer.

Export

The file contains

  • the repositories,
  • the stored passphrases (from the vault and the system keychain),
  • the SSH keys and the confirmed servers (known_hosts),
  • the backup jobs and the settings,
  • if you want, the borg keys of the repositories (for keyfile repositories).

It is encrypted with a password of its own (at least 12 characters; Argon2id + AES-256-GCM). Choose a good one: the file holds everything needed to open your backups.

External plugins are not part of an export; install them on the new computer yourself.

Import

Choose the file and enter its password. BorgStudio shows what the file contains and lets you

  • merge – add what is new, and decide per entry that exists on both sides which one to keep, or
  • replace everything.

On a computer without a PIN, BorgStudio offers to set one up (passphrases and SSH keys go into the vault). Keyfile keys are put back into borg's key folder.

After importing, check that borg is installed on the new computer (Installation) and try Test connection on each repository.

Clone this wiki locally