From c040c18795406c47c6b6c67a1c6dec111cceb5cb Mon Sep 17 00:00:00 2001 From: Test Date: Tue, 13 Oct 2026 16:00:46 +0200 Subject: [PATCH 1/2] docs(backup): say the family memory in Forgejo is not backed up yet The admin guide listed what the backup covers but not that Forgejo is missing from it, and Forgejo holds the family memory with its diary and lists. The memory stacklet only archives the files behind its pages. The backup stacklet's manifest now says why it is beta: which data is covered and which is not yet. --- docs/admin-guide.md | 2 +- stacklets/backup/stacklet.toml | 6 +++++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/admin-guide.md b/docs/admin-guide.md index 228ccfac..25bc58d5 100644 --- a/docs/admin-guide.md +++ b/docs/admin-guide.md @@ -793,7 +793,7 @@ newer commands (doctor, errors, memory, setup) and says so. ## Backups -This is the part everyone skips and regrets. famstack ships an opt-in backup stacklet that covers the irreplaceable data: photo originals, scanned documents, and everything in your family chat including the voice messages. Immich's and Paperless's databases are not covered yet, so layer it with Time Machine or a periodic tar if you want full coverage today. +This is the part everyone skips and regrets. famstack ships an opt-in backup stacklet that covers the irreplaceable data: photo originals, scanned documents, and everything in your family chat including the voice messages. Immich's and Paperless's databases are not covered yet, and neither is Forgejo, which holds the family memory with its diary and lists. Layer it with Time Machine or a periodic tar if you want full coverage today. ### The backup stacklet diff --git a/stacklets/backup/stacklet.toml b/stacklets/backup/stacklet.toml index cdadf687..a93fdebc 100644 --- a/stacklets/backup/stacklet.toml +++ b/stacklets/backup/stacklet.toml @@ -28,7 +28,11 @@ description = "Append-only backup of stacklet data to attached disks" version = "0.1.0" category = "infrastructure" type = "host" -# Beta: its configuration can still change between releases. +# Beta: it does not back up every stacklet's data yet. Covered: photo +# originals, the document files, the chat with its database and media, and +# the files behind memory pages. Not yet: the Immich and Paperless +# databases, and Forgejo, which holds the family memory with its diary and +# lists. The configuration can still change between releases. stage = "beta" # Backup runs once per night via a host-installed cron entry. The cron From 6a8477651db9ce56493e9fb9d958958edde326ff Mon Sep 17 00:00:00 2001 From: Test Date: Tue, 13 Oct 2026 16:00:46 +0200 Subject: [PATCH 2/2] docs(readme): say what the backup stacklet covers --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index f16983c5..941cb6eb 100644 --- a/README.md +++ b/README.md @@ -194,7 +194,7 @@ famstack comes with a lightweight bot runtime. The bots are tiny helpers that au | docs | working | Paperless-ngx | Document archive with OCR | | ai | working | TTS, Whisper, oMLX | Turns your Mac into an AI Machine | | memory | working | Forgejo, Quartz | Family wiki, diary and lists, kept as plain files | -| backup | beta | rsync | Append-only backups to an attached disk | +| backup | beta | rsync | Append-only backups of photos, documents and the chat | | agent | beta | nanobot | Stacky, the family agent in your chat | | chatai | beta | Open WebUI | ChatGPT-like chat interface | | code | beta | Forgejo | Private Git server |