This repository has been archived on 2026-06-19. You can view files and clone it, but you cannot make any changes to it's state, such as pushing and creating new issues, pull requests or comments.
kitestacks-cloud-migration/claude-memory/project-kitestacks.md
2026-06-09 23:09:57 -05:00

1.6 KiB

name description metadata
project-kitestacks KiteStacks homelab infrastructure — Docker Compose services, networking, autosync, Forgejo repo
node_type type originSessionId
memory project 301d23e2-6920-42b0-a27d-eba4e667b7f7

All services run as Docker Compose stacks in /home/kenpat/docker/<app>/. All containers join the kitestacks external Docker bridge network (172.18.0.0/16) — cloudflared uses container names as hostnames to route traffic. Cloudflare Tunnel (token-based) routes *.kitestacks.com → containers on the kitestacks network. Tunnel ingress rules are configured in the Cloudflare Zero Trust dashboard (not in local files).

Autosync system: A systemd service (kitestacks-autosync) watches /home/kenpat/docker/ via inotify and pushes any file change to the Forgejo repo kenpat/kitestacks-homelab at gitforge.kitestacks.com. Working repo lives at /opt/kitestacks-autosync/kitestacks-homelab/. User's local clone is at /home/kenpat/forgejo-repos/kitestacks-homelab/ (remote: http://100.90.13.55:3006/kenpat/kitestacks-homelab.git). Both point to the same Forgejo repo.

Versioned docs: Autosync auto-creates docs/KiteStacks-Homelab-Documentation-v1.3.NNN.md on each change. Manual/feature docs use the next version number. Current version as of 2026-06-08: 1.3.884.

Why: User always wants changes documented and pushed to Forgejo at the end of any task. How to apply: After making file changes, write docs to /home/kenpat/forgejo-repos/kitestacks-homelab/docs/, update CHANGELOG.md and README.md version tag, commit, and push. Use direct IP remote (no TLS issues).