kenpat/kitestacks-homelab
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
kitestacks-homelab/docs/KiteStacks-Homelab-Documentation-v1.3.922.md

2.4 KiB
Raw Permalink Blame History

KiteStacks Homelab Documentation v1.3.922

Version: 1.3.922 Updated: 2026-06-09 Previous: v1.3.921 docs

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.