Add first draft using info from the research

Refs: #11

Author: zmoog

obsidian/backup-an-obsidian-vault-to-github-repo.md

@@ -0,0 +1,95 @@
+# Backup an Obsidian vault to a GitHub repo
+
+I leverage iCloud to sync my vaults between my Mac, iPhone, and iPad. Unfortunately, iCloud doesn't offer you the following:
+
+- sync status
+- sync activity
+- file version history
+- file restore capabilities
+
+In the early time the servies was flacky, but in recent years has grown a lot, an now it sync pretty reliably. Still, the lack of the aforementioned feature make me feel anxious as the size of my vault increases over time.
+
+So I decided to add an offsite backup solution to the mix.
+
+Periodically commit and push vault file changes to a private GitHub repo.
+
+
+## Create a private GitHub repository
+
+```shell
+# Create a brand new private repository to host the files from the vault
+$ gh repo create zmoog/obsidian-vault-maintenance --private
+✓ Created repository zmoog/obsidian-vault-maintenance on GitHub
+
+# Walk into the vault directory
+cd /Users/${USER}/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/Maintenance
+
+# Initialize a new Git repository
+git init
+
+# Set the GitHub repository as remote
+git remote add origin [email protected]:zmoog/obsidian-vault-maintenance.git
+
+# set git options (they apply to this repository only)
+git config user.name "Automated"
+git config user.email "[email protected]"
+    
+# add everything changed to the stage
+git add -A
+
+# create the initial commit
+git commit -m "Latest data: ${timestamp}"
+
+# push and set the GitHub repository as upstream
+git push -u origin main
+```
+
+## Create a sync script
+
+```shell
+#!/bin/bash
+
+# make the script exit immediately if a command returns a non-zero exit status
+set -e
+
+# list of Obsidian vaults we want to sync
+vaults=("Elastic" "Knowledge")
+
+for vault in ${vaults[@]}
+do
+    # walk into the vault directory
+    cd /Users/${USER}/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/${vault}
+
+    # TODO: check this is a Git repository
+    #
+
+    # set git options for this repository only
+    git config user.name "Automated"
+    git config user.email "[email protected]"
+    
+    # add everything changed to the stage
+    git add -A
+
+    # commit everything changed
+    timestamp=$(date -u)
+    git commit -m "Latest data: ${timestamp}" || continue
+
+    # push the commit to the remote repo
+    git push    
+done
+```
+
+## Schedule the sync every few hours
+
+Open cron
+
+```shell
+crontab -e
+```
+
+Schedule the script execution every four hours:
+
+```shell
+0 */4 * * * /Users/zmoog/bin/sync-obsidian.sh
+```
+