gryf / py-time-machine

Rsync/hardlinks based python script for backup purposes using local or remote locations

py-time-machine

Rsync/hardlinks based python script for backup purposes using local or remote locations. Inspired by rsync-time-machine.

Features

Same as in rsync-time-machine, but also:

• Python3 support
• Backup to remote host
• Configuration will be read from XDG_CONFIG_HOME or /etc/
• Using yaml instead of ini style config files

Usage

Place the script on your path, create configuration and save it under convenient location.

Than, execute it:

$ py-time-machine.py

or provide configuration file:

$ py-time-machine.py -c file_with_configuration.yaml

There is an option for redirecting log to a file, by passing its location with --log parameter:

$ py-time-machine.py -c file_with_configuration.yaml -l ~/.ptm.log

or, as a root, using global configuration:

# py-time-machine.py -l /var/log/py-time-machine.log

Configuration

Sample configuration can be found with this repository with comments. To configure remote host, it's as simple as:

...
destination: user@hostname_or_ip_address:/path/to/the/backup
...

In this example user@ might be omitted, so that current user would be used. Please note, that in case of remote destination, absolute path should be used.

If needed, there is also a section, where rsh command might be tweaked, i.e. for usage different keys and/or ssh options:

...
rsh_command: >-
  ssh -i /path/to/ssh-key -o 'StrictHostKeyChecking=no' -o
  'UserKnownHostsFile=/dev/null'
...

Using yamls' >- notation all of the string will be concatenated and not terminated with newline character. Be careful, to not put special characters like dash or asterisk at the beginning of the broken line, or there will be issue with config reported.

License

See the LICENSE file for license rights and limitations (GNU GPL v2).