2016-12-13 19:28:37 +01:00
|
|
|
# borg_interface
|
|
|
|
|
2016-12-14 16:16:55 +01:00
|
|
|
This application provides an interface to borg backup. At a later point it might
|
|
|
|
as well work with restic.
|
|
|
|
|
2016-12-14 16:28:06 +01:00
|
|
|
### Installation
|
|
|
|
To install the application either "git clone" it in the folder you want with:
|
|
|
|
|
|
|
|
```
|
|
|
|
git clone https://git.2li.ch/Nebucatnetzer/borg_interface.git
|
|
|
|
```
|
|
|
|
|
|
|
|
or simply download it and extract the zip to your prefered location.:
|
|
|
|
* https://git.2li.ch/Nebucatnetzer/borg_interface/archive/master.zip
|
|
|
|
|
|
|
|
### Starting
|
|
|
|
Before starting the application make sure that you have configured it properly.
|
|
|
|
See the section [Configuration](https://git.2li.ch/Nebucatnetzer/borg_interface#configuration) for more details.
|
2016-12-14 22:09:13 +01:00
|
|
|
To start the application simply execute the borg_interface.sh file.
|
2016-12-14 16:16:55 +01:00
|
|
|
You will then see a list of options which are fairly self explanatory.
|
|
|
|
|
|
|
|
### Configuration
|
|
|
|
To configure borg_interface please edit the borg_interface.cfg file.
|
|
|
|
All the options have to be placed under the [DEFAULT] section.
|
|
|
|
The proper syntax is:
|
|
|
|
|
|
|
|
```
|
|
|
|
option: value
|
|
|
|
```
|
|
|
|
|
|
|
|
or
|
|
|
|
|
|
|
|
```
|
|
|
|
option=value
|
|
|
|
```
|
|
|
|
|
|
|
|
Possible values as of now are:
|
|
|
|
|
|
|
|
##### server
|
|
|
|
define a server on which the archive reside.
|
|
|
|
|
|
|
|
##### user
|
|
|
|
defines the user which has permission to connect to the server.
|
|
|
|
|
|
|
|
##### repository_path
|
|
|
|
defines the path where the repository is set up.
|
|
|
|
This is needed for both a remote and a local repository.
|
|
|
|
|
|
|
|
##### password
|
|
|
|
defines the repository password
|
|
|
|
|
|
|
|
### Example Config
|
2016-12-14 16:18:07 +01:00
|
|
|
```
|
2016-12-14 16:19:58 +01:00
|
|
|
[DEFAULT]
|
2016-12-14 16:16:55 +01:00
|
|
|
server: testserver.local
|
|
|
|
user: borg
|
|
|
|
repository_path: /home/borg/backup/repository
|
|
|
|
password: foo
|
2016-12-14 16:18:07 +01:00
|
|
|
```
|