From 40d540356598bb0c5f2cea6527a417ab81adaef1 Mon Sep 17 00:00:00 2001 From: Nicco Date: Sun, 21 Jan 2018 12:38:52 +0100 Subject: [PATCH] Readme --- README.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 68 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d844c04..58d6e9c 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,68 @@ -# ixesha -Incremental snapshot backup utility +# Ixesha + +Make incremental snapshots to backup any folder to any location/server. 💪 + +Written in python. 🐍 + +###### Example + +```bash +python3 ixesha.py --backup ~/ --output /mnt/backup/home +``` + +## Setup + +### Requirements 💾 +- `Python3` +- `rsync` (min. v3.1.1) + +### Installation + +###### macOS + +1. Install brew: `/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"` +2. Install `python3` and `rsync`: `brew install python3 rsync` + +###### debian / ubuntu + +1. `apt install -y python3 rsync` + +###### windows + +Well... I don't know 😅 + + +## Usage 🚀 + +### Run 👾 + +```bash +python3 ixesha.py [-h|--help] -b|--backup -o|--output +# or +./ixesha -b -o +``` + +###### Example + +Backup my home folder for example to some mounted drive +```bash +python3 ixesha.py --backup ~/ --output /mnt/backupdrive/home +``` + + +### Arguments + +- `-h` `--help` Show help dialog +- `-b` `--backup` The folder to be backed up +- `-o` `--output` Location where the snapshots will be saved + + +### Cron + +If you want to run it every x... you can create a cronjob + +###### Example: +Run the script every 5 Min (More details on [cronjobs](http://www.cyberciti.biz/faq/how-do-i-add-jobs-to-cron-under-linux-or-unix-oses/)) + +1. Edit your cron file with: `crontab -e` +2. Add: `*/5 * * * * python3 /path/to/ixesha.py -b /some/folder -o /some/backup/location`