Repository navigation
Installation
BorgStudio is a portable app: download, unpack, start. It contains the .NET runtime, nothing else needs to be installed for the app itself. BorgBackup has to be installed separately.
Get the package for your system from the releases page:
| System | File |
|---|---|
| Windows (x64) |
BorgStudio-<version>-win-x64.zip – one file, BorgStudio.exe
|
| macOS, Apple Silicon (M1 and newer) |
BorgStudio-<version>-osx-arm64.zip – contains BorgStudio.app
|
| macOS, Intel | BorgStudio-<version>-osx-x64.zip |
| Linux (x64) |
BorgStudio-<version>-linux-x64.tar.gz – folder BorgStudio
|
Unpack it into a folder of your own (for example C:\Tools\BorgStudio, ~/Applications or ~/opt/BorgStudio) and
start BorgStudio. Keep it in a folder you may write to: BorgStudio updates itself
there.
macOS: the app is not notarized by Apple. If macOS refuses to open it, allow it under System Settings → Privacy & Security → Open Anyway, or run once:
xattr -dr com.apple.quarantine BorgStudio.appLinux: the archive keeps the executable bit; start BorgStudio/BorgStudio.
BorgStudio needs borg 1.2 or newer, 1.4 is recommended. borg 2 is still in beta and not supported yet.
| System | How |
|---|---|
| Windows | borg has no Windows version: install it inside WSL. In a PowerShell: wsl --install -d Ubuntu, restart if asked, then in Ubuntu: sudo apt update && sudo apt install borgbackup
|
| macOS |
brew install borgbackup (Homebrew) |
| Debian, Ubuntu | sudo apt install borgbackup |
| Fedora | sudo dnf install borgbackup |
| Other | see the borg installation guide |
BorgStudio looks for borg on PATH, in the usual install locations (for example Homebrew) and, on Windows, inside
WSL. The status bar at the bottom shows which borg it uses, for example borg 1.4.4 · WSL: /usr/bin/borg. If borg is
missing or too old, a notice explains what to do; Check again looks once more after installing.
- Folders on your Windows drives are backed up through WSL (
C:\Users\…is/mnt/c/Users/…there). BorgStudio shows and restores them with their Windows paths. - SSH keys for borg are kept in BorgStudio's vault and handed to borg inside WSL only for the duration of a call.
- Mounting archives needs a one-time setting in WSL, which BorgStudio offers to make.
From version 0.2.0 on, BorgStudio looks for new versions itself and installs them after asking – see Settings and updates. Version 0.1.0 has no updater: replace it once by hand with the new download.
Next: Getting started.