kenpat/kitestacks-homelab
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
964 commits 2 branches 0 tags 739 MiB
Commit graph

16 commits

Author SHA1 Message Date
kenpat
fb822d5142 Reorganize repos into kitestacks-homelab + plain-English doc rewrite 
- Rewrote RUNBOOK.md and DEBUG-DOCUMENTATION.md in simple 5th-grade language
  with real-world analogies for every technical concept
- Updated README.md with current service inventory and folder map
- Added cloud-migration/ subdirectory (from kitestacks-cloud-migration repo)
- Added autosync/ subdirectory (from kitestacks-homelab-autosync-test repo)
- Added osticket/ subdirectory (from OSTicketSystem repo)
- Added cloud/ placeholder for future cloud configs
- Excluded binary DB/postgres files from autosync subdirectory

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-18 18:37:58 -05:00
kenpat
4dc535905a Update RUNBOOK with BookStack OIDC fix and kscloud1 SSH recovery 2026-06-18 21:08:03 +00:00
kenpat
e69f236c89 docs: document phantom 3rd tunnel replica fix + update runbook for 2-connector arch 
- DEBUGGING.md: add issue #9 — native cloudflared systemd running alongside Docker
  container causes phantom 3rd replica in CF dashboard; fix is to disable systemd service
- RUNBOOK.md: correct architecture diagram from 3 connectors to 2 (monk Docker + kscloud1);
  add warning to disable native cloudflared systemd after containerizing; update failover
  test procedure with verified 2026-06-16 results (zero downtime confirmed)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-16 21:35:23 -05:00
kenpat
d439a1bb46 docs: document ntfy 502 error and multi-node tunnel requirements 2026-06-15 15:51:06 -05:00
kenpat
c4c6b49bf4 docs: clean up runbook and create dedicated debugging guide 2026-06-15 15:23:44 -05:00
kenpat
bddfb8179d docs: update runbook with k3s/flux install and bootstrap steps 2026-06-15 12:45:23 -05:00
kenpat
4545b5c5e0 chore: rename assassin cluster to T14s and add kavita gitops manifests 2026-06-15 11:56:59 -05:00
kenpat
24be0b06c8 phase 8: forgejo sync config, authentik-ldap SSO service, runbook update 2026-06-15 08:54:08 -05:00
kenpat
bd76c9f448 v1.4.0: OSticket replaces OpenProject, Portainer SSO live, auth code TTL fix 
- OpenProject → OSticket (campbellsoftwaresolutions/osticket + MariaDB + nginx:8080 proxy)
- Portainer SSO configured via API on both monk and kscloud1, portal card live
- OAuth2 access_code_validity 1min → 10min (fixes reconnect race condition)
- Karakeep redirect_uri re-fixed to /api/auth/callback/custom
- RUNBOOK Phase 3, 5.8, 5.11, 6.1, portal panels all updated
- CHANGELOG v1.4.0 added
 2026-06-12 13:42:20 -05:00
KiteStacks AutoSync
4b8925ca7e security: complete IP, port, and password redaction across all docs 
Redact all remaining IPv4 addresses, port numbers, and credential values
from RUNBOOK.md, AUTHENTIK.md, and authentik-sso-setup.md. Replace with
descriptive placeholders (<IP_REDACTED>, <port>, <REDACTED>, etc.).
Docker image version tags (postgres:16, forgejo:11, etc.) preserved.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-11 16:16:23 -05:00
KiteStacks AutoSync
e409b461d8 security: redact all IPs, ports, and passwords from docs 
Replace all production IPs (public, LAN, Tailscale), host port bindings,
and hardcoded passwords/secrets across RUNBOOK.md, docs/, and projects/
with descriptive placeholders (<KSCLOUD1_PUBLIC_IP>, <port>,
<KSCLOUD1_SUDO_PASSWORD>, etc.) so no sensitive infrastructure details
are committed to the repository.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-11 16:05:53 -05:00
kenpat
c231bcce70 Update RUNBOOK.md 2026-06-11 20:56:03 +00:00
KiteStacks AutoSync
24458bd5d1 docs: rewrite RUNBOOK.md as complete start-to-finish setup guide 
Replaces the stub runbook with a comprehensive setup guide covering the
entire KiteStacks homelab from scratch — monk (primary host), kscloud1
(Hetzner cloud replica), Cloudflare Tunnel, Tailscale mesh, shared
Authentik Postgres+Redis, all 9 services with full compose configs,
Authentik SSO for every app, kscloud1 replica deployment, portal UI,
monitoring, Discord integration, and a full verification checklist.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-06-11 15:51:39 -05:00
kenpat
8a014d27bc docs: update runbook for monk as primary host + kscloud1 active cloud failover 2026-06-11 18:46:09 +00:00
KiteStacks AutoSync
68995fd94a docs: add Hetzner cloud redundancy deployment runbook 2026-06-10 04:05:16 -05:00
KiteStacks AutoSync
1b2461425f docs: add root homelab runbook and debug documentation 2026-06-09 03:32:33 -05:00