Go to file
2017-11-26 00:01:17 +01:00
sync_file_range_test check for sync_file_range and patch 2017-11-26 00:01:17 +01:00
borg_ssh_wrapper Use $* over $1..$8 in borg_ssh_wrapper 2017-07-30 17:30:24 +02:00
borg_sync_file_range.patch check for sync_file_range and patch 2017-11-26 00:01:17 +01:00
build.sh check for sync_file_range and patch 2017-11-26 00:01:17 +01:00
LICENSE Initial commit 2017-07-29 16:58:11 +02:00
README.md check for sync_file_range and patch 2017-11-26 00:01:17 +01:00

borgbackup on android

This project provides build scripts to compile borgbackup (https://github.com/borgbackup/borg) and its dependencies on Android. It uses termux (https://termux.com/) as a lightweight environment.

Yoou don't root permission on your phone to use it. However without root permissions the access to data of other apps or system data is not possible, but you can still access your photos, videos,...

If you have root permission on your device, you can use tsu (https://github.com/cswl/tsu) to conveniently gain root permissions in termux and backup you complete device.

How to use:

Known issues:

  • borg starting at 1.1 requires the system call sync_file_range (see https://github.com/borgbackup/borg/pull/985 and https://github.com/borgbackup/borg/issues/1961). The linux subsystem in Windows 10 and some older Android versions (for example Lineage including 14.1) do not yet have this. Lineage 15.0 has this call and should work. I have added a test to the build script that checks if sync_file_range is available. If it is not, then I apply a patch (borg_sync_file_range.patch) that replaces this sync with convential file syncs.

Tested with:

  • termux 0.56
  • borg 1.0.12, 1.1.3

Tested and working so far is:

  • creation of repositories
  • backup to repositories on the device
  • backup up to remote repositories via ssh

Tested and working on devices:

  • Huawei Nexus6p with stock Android 8.0.0 (angler, aarch64)
  • Samsung Galaxy Note 2 with Lineage 14.1 (n7100, armv7l, Android 7.1.1)

Feedback on tests with other devices and android versions is very welcome.

Warning messages like

WARNING: linker: /data/data/com.termux/files/usr/lib/libacl.so.1.1.0: unused DT entry: type 0xf arg 0x449

are due to the Android linker. More details can be found at https://stackoverflow.com/questions/33206409/unused-dt-entry-type-0x1d-arg.

So all in all my Android backup setup looks like:

#!/data/data/com.termux/files/usr/bin/bash
date
tsu -e -c "~/borgbackup_on_android/borg.sh"
date
read
  • ~/borgbackup_on_android/borg.sh:
#!/data/data/com.termux/files/usr/bin/bash
t=`date +%d_%m_%Y`
export BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK=yes
export BORG_RELOCATED_REPO_ACCESS_IS_OK=yes
host=angler
dirs="/ /system /vendor /cache /persist /firmware /storage /data"
export BORG_RSH=borg_ssh_wrapper
source /data/data/com.termux/files/home/borgbackup_on_android/borg-env/bin/activate
borg create -C lz4 -p -v --stats --one-file-system backup:/backup/borg/$host::$t $dirs # 2> ~/borg_backup_${t}.err