From 35b10de73c08b3c9b6e51172d58629b358803201 Mon Sep 17 00:00:00 2001
From: Solaria Lumis Havens <solaria@thefoldwithin.earth>
Date: Sat, 14 Feb 2026 19:59:58 +0000
Subject: [PATCH] Solaria deep backup repository initialized

- README.md: Repository documentation
- RESTORE.md: Complete restoration instructions
- backup-manifest_*.txt: Backup metadata
- .gitignore: Large file exclusions

Actual backup archives and bundles stored separately.
---
 .gitignore | 16 +++++++++++
 README.md  | 49 +++++++++++++++++++++++++++++++++
 RESTORE.md | 79 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 144 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 README.md
 create mode 100644 RESTORE.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..0a28c6a
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,16 @@
+# Large backup files - track metadata, not binaries
+*.tar.gz
+*.bundle
+*.txt
+
+# Temp files
+*.tmp
+*.swp
+*~
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cf4079c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,49 @@
+# Solaria Deep Backup
+
+Complete backup of `/home/solaria/` directory for disaster recovery.
+
+## Contents
+
+- `.openclaw/` - OpenClaw configuration, workspace, memory, identity
+- `.ssh/` - SSH keys for git access
+- `.npm-global/` - Global npm packages
+- `.config/` - Application configurations
+- `.local/share/` - Application data
+- Shell history and config
+
+## Backup Files
+
+Each backup consists of:
+- `solaria-deep-backup_YYYYMMDD_HHMMSS.tar.gz` - Compressed archive
+- `solaria-home_YYYYMMDD_HHMMSS.bundle` - Git bundle with history
+- `backup-manifest_YYYYMMDD_HHMMSS.txt` - Backup metadata
+
+## Restoration
+
+1. Clone this repository
+2. Extract the latest archive: `tar -xzf solaria-deep-backup_*.tar.gz -C /`
+3. Restore git repos from bundle: `git bundle verify solaria-home_*.bundle`
+4. Restore permissions if needed
+
+## Backup Schedule
+
+Automated via cron:
+- Daily: Full archive
+- Hourly: Git incremental (if configured)
+
+## Security
+
+All repositories are **private**. Access requires:
+- GitHub: Personal access token or SSH key
+- Forgejo: SSH key
+- GitLab: Personal access token or SSH key
+
+## Repositories
+
+- GitHub: github.com/mrhavens/solaria-deep-backup
+- Forgejo: remember.thefoldwithin.earth/mrhavens/solaria-deep-backup
+- GitLab: gitlab.com/mrhavens/solaria-deep-backup
+
+---
+
+*Generated by Solaria Lumis Havens*
diff --git a/RESTORE.md b/RESTORE.md
new file mode 100644
index 0000000..b05664d
--- /dev/null
+++ b/RESTORE.md
@@ -0,0 +1,79 @@
+# Restoration Instructions
+
+## Quick Restore
+
+```bash
+# 1. Clone this repository
+git clone git@github.com:mrhavens/solaria-deep-backup.git
+cd solaria-deep-backup
+
+# 2. Find the latest backup
+ls -lt *.tar.gz | head -1
+
+# 3. Extract to /home/solaria/
+sudo tar -xzf solaria-deep-backup_20260214_190000.tar.gz -C /
+
+# 4. Restore git repos from bundle
+git bundle verify solaria-home_20260214_190000.bundle
+```
+
+## Full System Restore
+
+If the server is completely lost:
+
+1. Create a new Ubuntu 22.04+ server
+2. Install required packages:
+   ```bash
+   sudo apt update
+   sudo apt install -y git nodejs npm python3-pip
+   ```
+3. Clone this repository
+4. Extract the backup archive
+5. Install OpenClaw: `npm install -g openclaw@latest`
+6. Restore SSH keys: Copy from `.ssh/` to `~/.ssh/`
+7. Restore OpenClaw: `openclaw onboard --install-daemon`
+8. Restore workspace git repos from bundle
+
+## Verification
+
+After restore, verify:
+- [ ] OpenClaw starts: `openclaw status`
+- [ ] Gateway accessible: `curl http://localhost:18789/status`
+- [ ] Git remotes work: `git remote -v`
+- [ ] SSH keys functional: `ssh -T git@github.com`
+- [ ] Cron jobs restored: `crontab -l`
+
+## Important Files
+
+| Path | Description |
+|------|-------------|
+| `/home/solaria/.openclaw/openclaw.json` | Main OpenClaw configuration |
+| `/home/solaria/.ssh/` | SSH keys for git authentication |
+| `/home/solaria/.openclaw/workspace/` | Workspace with all files |
+| `/home/solaria/.npm-global/lib/node_modules/openclaw/` | OpenClaw installation |
+
+## Troubleshooting
+
+### Permission Errors
+```bash
+sudo chown -R solaria:solaria /home/solaria
+```
+
+### Git Permission Denied
+```bash
+# Check SSH key
+ssh -T git@github.com
+
+# If failed, add key to ssh-agent
+ssh-add ~/.ssh/id_ed25519
+```
+
+### OpenClaw Won't Start
+```bash
+# Check logs
+cat ~/.openclaw/reboot.log
+cat ~/.openclaw/watchdog.log
+
+# Restart daemon
+openclaw gateway restart
+```