Document cloud migration backup pushed to Forgejo (v1.3.922)

docs/KiteStacks-Homelab-Documentation-v1.3.922.md

@@ -0,0 +1,38 @@
+# KiteStacks Homelab Documentation v1.3.922
+
+**Version:** 1.3.922
+**Updated:** 2026-06-09
+**Previous:** [v1.3.921 docs](KiteStacks-Homelab-Documentation-v1.3.921.md)
+
+---
+
+## Change Summary
+
+### Cloud Migration Backup Pushed to Forgejo
+
+- Created Forgejo repo `kenpat/kitestacks-cloud-migration`, set to **private** (contains `.env` files, tunnel tokens, app credentials).
+- Pushed the full migration backup from `/home/kenpat/kitestacks-cloud` (commit `6ffcbea`, ~4.3GB total).
+- Large files (archives + Docker volume exports, ~2.3GB across 14 files) tracked via **Git LFS**, since these were too big for normal git objects.
+- Verified all 15 LFS objects are present server-side and match the OIDs/sizes recorded in `SHA256SUMS`.
+
+### Repo Contents (`kitestacks-cloud-migration`)
+
+- `archives/docker-bind-data.tar.gz` — `/home/kenpat/docker` bind-mounted service folders (compose files, `.env` files, app data)
+- `archives/syncthing-shared.tar.gz` — `/home/kenpat/SyncthingShared`
+- `archives/kitestacks-scripts.tar.gz` — local automation/script folders
+- `archives/host-etc-subset.tar.gz` — selected host `/etc` config
+- `volume-exports/*.tar.gz` — Docker named volume exports (kite-ai/open-webui, openproject db/pgdata/assets/logs, portainer, uptime-kuma, etc.)
+- `inventory/*` — Docker, network, disk, config, and host inventory snapshots
+- `restore/RESTORE.md` — first-pass restore procedure
+- `SHA256SUMS` — checksums for all files in the backup
+
+### Known Issue: Cloudflare Tunnel LFS Upload Limit
+
+- Forgejo's public hostname `gitforge.kitestacks.com` (via Cloudflare Tunnel) returns **HTTP 413** for LFS uploads/downloads over ~100MB.
+- Workaround used for upload: PUT large LFS objects directly to `http://100.90.13.55:3006/...` (local Tailscale IP), bypassing Cloudflare.
+- Same limit will likely apply to `git lfs pull` for the 3 large objects (docker-bind-data.tar.gz ~967MB, kite-ai_open-webui.tar.gz ~963MB, syncthing-shared.tar.gz ~165MB) when accessed via the public hostname — pull via the local IP/Tailscale instead.
+
+### Migration Plan (Tracked Going Forward)
+
+- **Phase 1 (current):** Full server backup archived in `kenpat/kitestacks-cloud-migration` on Forgejo. Goal — be able to pull this repo onto a new desktop and physically relaunch the homelab from it.
+- **Phase 2 (planned):** Stand up an Oracle Cloud VPS and load the server stack into the cloud, so services stay up even when the desktop is asleep/off.