borg-remote-android/README.md
2018-09-23 13:41:52 -04:00

35 lines
1.4 KiB
Markdown

# borg-remote-android
A utility for easy android backups using rsync (locally) and borg (on a remote).
## Motivation
I was having trouble installing borg (even though there was [borgbackup_on_android](https://github.com/ravenschade/borgbackup_on_android)) and running borg was slow since I was using lzma compression.
I created this tool so that the copy to the server could be quick, then the server could perform the heavy lifting of encryption/compression. This also allows for less required time on WiFi, since the only network-intensive operations are on the resumable rsync transfer.
## Usage
In Termux, run:
```bash
./backup-android.sh
```
and it will notify you when complete.
Alternatively, you can add a Termux widget to your home screen (`./setup.sh` auto-installs in the `.shortcuts` directory), so backups can be made with a single tap from the home screen.
## Installation
Quick, 4 line installation:
```bash
apt update
apt install -y git rsync openssh
git clone https://gitea.austenwares.com/stonewareslord/borg-remote-android
env bash borg-remote-android/setup.sh
```
Same installation as a one-liner
```bash
apt update && apt install -y git rsync openssh && git clone https://gitea.austenwares.com/stonewareslord/borg-remote-android && env bash borg-remote-android/setup.sh
```
## Updating
The entire config is stored in `env`, which is in `.gitignore`, so running a simple `git pull` will update without losing custom changes.