summaryrefslogtreecommitdiff
path: root/bin/README.md
diff options
context:
space:
mode:
authorskylar <me@casper>2026-11-01 16:41:26 -0800
committerskylar <me@casper>2026-11-01 16:41:26 -0800
commit5c0715431c0ec225dd06af5e7d42a28f196af780 (patch)
tree8a9e4709959e57b328258614d8b9c9c09c139b1c /bin/README.md
parentb6c9feb9e223c88dcad3f4bff39ae9a01e7cdad0 (diff)
bin: add vpsbackup, a daily pull backup of the VPS
vpsbackup pulls the VPS over a read-only rsync key into a local mirror (--fake-super keeps owners, modes and symlinks in xattrs) and snapshots it into a local restic repository, hourly until a day has passed. Failures are mailed through the VPS's own postfix, and a watch timer it installs there mails when no backup has arrived for three days. A dropped connection is retried next hour rather than reported. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'bin/README.md')
-rw-r--r--bin/README.md3
1 files changed, 3 insertions, 0 deletions
diff --git a/bin/README.md b/bin/README.md
index 6c32c13..52593e9 100644
--- a/bin/README.md
+++ b/bin/README.md
@@ -9,10 +9,13 @@ and the config looks for it on `PATH` before falling back to this directory.
| `docsync` | Backups | restic, ssh, jq, notify-send |
| `imgcollage` | Media thumbnails > Collage | Python 3, Pillow |
| `system-theme` | Appearance > Theme | the COSMIC desktop |
+| `vpsbackup` | (standalone) | restic, rsync, ssh |
Each script's header or usage message (`docsync help`) says how to set it up.
`systemd/` holds docsync's user units: copy them to `~/.config/systemd/user/`,
put `docsync` at `~/.local/bin/docsync`, and enable the three timers.
+`vpsbackup.timer` and `.service` likewise run `~/.local/bin/vpsbackup`, which
+pulls the VPS here daily; `vpsbackup help` covers its setup and restores.
`photocollage/` is vendored unchanged from
[PhotoCollage](https://github.com/adrienverge/PhotoCollage) by Adrien Vergé,