1 files changed, 43 insertions, 2 deletions
diff --git a/README.md b/README.md
index 22d1f89..483bc95 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,43 @@
-borger
-======
+# Borger
+
+A script for home folder backups using [Borg](https://borgbackup.readthedocs.io).
+
+# Features
+
+* Multiple destinations using config files.
+* Automatically initializes repository in the remote destination.
+* Automatically pruning of old backups.
+
+# Usage
+
+Create a config for your `servername` destination at `~/.config/borger/servername`:
+
+     # Backup destination
+     export SSH_SERVER="user@host"
+     export SSH_PORT="2202"
+  
+     # Repository path
+     export BORG_REPO_DIR="/var/backups/users/$USER/borg"
+     export BORG_REPO="ssh://$SSH_SERVER:$SSH_PORT/$BORG_REPO_DIR"
+  
+     # Setting one of those, so you won't be asked for your repository passphrase:
+     #export BORG_PASSPHRASE='HACKME'
+     #export BORG_PASSCOMMAND='pass show backup'
+     #export BORG_PASSCOMMAND='keyringer default decrypt borg 2> /dev/null'
+  
+     # Backup config
+     keepdaily="7"
+     keepweekly="4"
+     keepmonth="6"
+     encryption="keyfile"
+     placeholder="{user}"
+
+Then run borger:
+
+    borger servername
+
+# Checking your backups
+
+As simply as
+
+    borger servername --check