mirror/borg
1
0
Fork 0
mirror of https://github.com/borgbackup/borg.git synced 2025-01-23 07:48:55 +00:00
Code Issues Releases Wiki Activity

Updated windows readme with current state

Browse source
This commit is contained in:
Jürg Rast 2019-08-08 23:51:21 +02:00
parent bff97a99e1
commit a81dffa54e
1 changed files with 19 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
README_WINDOWS.rst
View file

@ -1,19 +1,34 @@
Borg Native on Windows 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 Build Requirements
------------------ ------------------
- VC 14.0 Compiler - VC 14.0 Compiler
- OpenSSL Library (https://slproweb.com/products/Win32OpenSSL.html) - OpenSSL Library v1.1.1c, 64bit (available at https://slproweb.com/products/Win32OpenSSL.html)
- Patience and a lot of coffee / beer - Patience and a lot of coffee / beer
What's working 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 does not crash if called with ``borg``
- ``borg init --encryption none ./demoRepo`` runs without an error/warning. - ``borg init --encryption repokey-blake2 ./demoRepo`` runs without an error/warning.
Note that only relative paths work at the moment. 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.