Skip to content

mikeshultz/undine

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

undine

A wrapper for handling multi-archive backups with Borg

Usage

usage: undine [-h] [--dry-run] [-v] [-d] [-l LOCKFILE]

A wrapper for handling multi-archive backups with Borg

optional arguments:
  -h, --help            show this help message and exit
  --dry-run             Do not actually create archives.
  -v, --verbose         Show output
  -d, --debug           Show debug output
  -l LOCKFILE, --lock-file LOCKFILE
                        Lock file to use

SSH Configuration

While not strictly required, if you're using SSH to connect to the backend, using ~/.ssh/config will make things much easier. For insance, if using rsync.net, you could do something like the following:

Host rsync.net
        Hostname example.rsync.net
        IdentityFile /home/user/.ssh/id_rsa.rsync.net
        User 123

Installation

First, python must be available on your system(2.7 or 3.4+).
Borg must also be installed.

Then install undine like so:

python setup.py install

Borg Setup

The repositories that undine will use(the repos argument in the ini) need to be initialized before any backups can use the repository. I like to create a repository for each system. This might be how you would want to init your repos:

borg init --remote-path=borg1  rsync.net:this.example.org

Configuration

Configuration is done through an INI file. It can be placed in /etc/undine.ini or ~/.config/undine.ini. The one in the user directory will take precidence. The available options are below:

[default]
debug = False
verbose = False
hostname = this.example.org
repos = ssh://rsync.net/path/to/repos
notify_email = root@example.org
lockfile = /tmp/undine.lock

[smtp]
host = localhost
port = 589
login =
password =
tls = true

[units]
home = /home
etc = /etc
postgres = /var/lib/pgsql

About

A wrapper for handling multi-archive backups with Borg

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Python 100.0%