Skip to content

Latest commit

 

History

History
48 lines (37 loc) · 2.06 KB

README_WINDOWS.rst

File metadata and controls

48 lines (37 loc) · 2.06 KB

Borg Native on Windows

Running borg natively on windows is in a early alpha stage. Expect many things to fail. Do not use the native windows build on any data which you do not want to lose!

Build Requirements

  • VC 14.0 Compiler
  • OpenSSL Library v1.1.1c, 64bit (available at https://github.com/python/cpython-bin-deps) Please use the win-download-openssl.ps1 script to download and extract the library to the correct location. See also the OpenSSL section below.
  • Patience and a lot of coffee / beer

What's working

Note

The following examples assume that the BORG_REPO and BORG_PASSPHRASE environment variables are set if the repo or passphrase is not explicitly given.

  • Borg does not crash if called with borg
  • borg init --encryption repokey-blake2 ./demoRepo runs without an error/warning. Note that absolute paths only work if the protocol is explicitly set to file://
  • borg create ::backup-{now} D:\DemoData works as expected.
  • borg list works as expected.
  • borg extract --strip-components 1 ::backup-XXXX works. If absolute paths are extracted, it's important to pass --strip-components 1 as otherwise the data is resotred to the original location!

What's NOT working

  • Extracting a backup which was created on windows machine on a non windows machine will fail.
  • And many things more.

OpenSSL, Windows and Python

Windows does not ship OpenSSL by default, so we need to get the library from somewhere else. However, a default python installation does include libcrypto which is required by borg. The only things which are missing to build borg are the header and *.lib files. Luckily the python developers provide all required files in a separate repository. The win-download-openssl.ps1 script can be used to download the package from https://github.com/python/cpython-bin-deps and extract the files to the correct location. For Anaconda, the required libraries can be installed with conda install -c anaconda openssl.