summaryrefslogtreecommitdiffstats
path: root/roles/backup/README.md
diff options
context:
space:
mode:
authorAhmed Abdelhalim <[email protected]>2026-07-22 22:06:30 +0200
committerAhmed Abdelhalim <[email protected]>2026-07-22 22:06:30 +0200
commitc5660fc2f031a74cbdc14518f296f91822ed52c3 (patch)
tree1346cda3e81bcbfb5bf03c1f4f7af3563f697fce /roles/backup/README.md
parent0f3f5a12a4b9656a4e057f6c13c3c03b8ed2c74a (diff)
Fix pve-lxc start and add missing docs about backup
Diffstat (limited to 'roles/backup/README.md')
-rw-r--r--roles/backup/README.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/roles/backup/README.md b/roles/backup/README.md
index 88bdf7d4..63c14fff 100644
--- a/roles/backup/README.md
+++ b/roles/backup/README.md
@@ -75,6 +75,31 @@ and can restore a snapshot back on demand.
run), `restic backup <paths>`, then `restic forget --prune` using the configured
retention.
+## Manual Backup
+
+The scheduled timer/cron just calls the same script deployed to
+`/usr/local/bin/{{ backup_name }}-backup` — run it directly to back up on demand:
+
+```bash
+sudo /usr/local/bin/{{ backup_name }}-backup
+```
+
+To verify the snapshot landed, via restic:
+
+```bash
+source /etc/credstore/{{ backup_name }}-backup.env
+export RESTIC_REPOSITORY="$BACKUP_REPO" RESTIC_PASSWORD="$BACKUP_PASSWORD" \
+ AWS_ACCESS_KEY_ID="$BACKUP_ACCESS_KEY_ID" AWS_SECRET_ACCESS_KEY="$BACKUP_SECRET_ACCESS_KEY"
+restic --cache-dir "/var/cache/{{ backup_name }}-backup" snapshots
+```
+
+Or via the S3 backend directly, from a host with `awscli` configured against it —
+restic prefixes every job's objects under `{{ backup_name }}` within the bucket:
+
+```bash
+aws s3 ls s3://<bucket>/{{ backup_name }}/ --recursive
+```
+
## Restore Process
Restore never runs automatically — every restore-related task is tagged