Skip to content

Installation

cuban8IO edited this page Nov 9, 2026 · 1 revision

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.

1. Download BorgStudio

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.app

Linux: the archive keeps the executable bit; start BorgStudio/BorgStudio.

2. Install borg

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.

Windows: borg in WSL

  • 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.

3. Updating

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.

Clone this wiki locally