Commit graph

956 commits

Author SHA1 Message Date
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
f79478158d Update DEBUG-DOCUMENTATION with BookStack SSO and kscloud1 SSH incidents 2026-06-18 21:08:10 +00:00
4dc535905a Update RUNBOOK with BookStack OIDC fix and kscloud1 SSH recovery 2026-06-18 21:08:03 +00:00
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
d439a1bb46 docs: document ntfy 502 error and multi-node tunnel requirements 2026-06-15 15:51:06 -05:00
c4c6b49bf4 docs: clean up runbook and create dedicated debugging guide 2026-06-15 15:23:44 -05:00
bdec86b16f fix: downgrade kustomize apiVersion to v1beta1 2026-06-15 13:04:59 -05:00
ce67f391f5 fix: use tailscale SSH URL for GitRepository 2026-06-15 12:59:20 -05:00
bddfb8179d docs: update runbook with k3s/flux install and bootstrap steps 2026-06-15 12:45:23 -05:00
4545b5c5e0 chore: rename assassin cluster to T14s and add kavita gitops manifests 2026-06-15 11:56:59 -05:00
24be0b06c8 phase 8: forgejo sync config, authentik-ldap SSO service, runbook update 2026-06-15 08:54:08 -05:00
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
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
a9f25945ad fix: Discord #recent-activities webhook delivery (empty meta/username) 2026-06-11 20:00:39 +00:00
4b5b098464 docs: Discord #recent-activities webhook live - test push 2026-06-11 19:07:39 +00:00
dbbb776808 docs: correct disaster recovery runbook (monk primary, kscloud1 active-active, Forgejo activity fix) 2026-06-11 18:46:09 +00:00
8a014d27bc docs: update runbook for monk as primary host + kscloud1 active cloud failover 2026-06-11 18:46:09 +00:00
KiteStacks AutoSync
fdac5ef6f0 docs: add disaster recovery runbook 2026-06-10 05:09:36 -05:00
KiteStacks AutoSync
bdd4e43254 chore: stop tracking runtime database and container data 2026-06-10 04:09:06 -05:00
KiteStacks AutoSync
68995fd94a docs: add Hetzner cloud redundancy deployment runbook 2026-06-10 04:05:16 -05:00
Kenpat7177
7427b2d0d1 Document cloud migration backup pushed to Forgejo (v1.3.922) 2026-06-09 23:10:34 -05:00
Kenpat7177
95b6a07453 Remove Shaarli; switch to Raindrop.io cloud for bookmark management (v1.3.921)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-09 10:44:25 -05:00
Kenpat7177
d6c4812b73 Remove Shaarli; switch to Raindrop.io cloud for bookmark management
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-09 10:40:46 -05:00
KiteStacks AutoSync
1b2461425f docs: add root homelab runbook and debug documentation 2026-06-09 03:32:33 -05:00
KiteStacks AutoSync
55594d4c87 Automated update: 2026-06-09 03:14:40 2026-06-09 03:14:40 -05:00
KiteStacks AutoSync
b2a6716d21 Automated update: 2026-06-09 02:54:20 2026-06-09 02:54:20 -05:00
KiteStacks AutoSync
fd5f035d16 Automated update: 2026-06-09 02:33:26 2026-06-09 02:33:26 -05:00
KiteStacks AutoSync
2ad3c7b6d2 Automated update: 2026-06-09 02:12:47 2026-06-09 02:12:47 -05:00
KiteStacks AutoSync
b8b96ff91d Automated update: 2026-06-09 01:51:45 2026-06-09 01:51:45 -05:00
KiteStacks AutoSync
7b06744704 Automated update: 2026-06-09 01:31:21 2026-06-09 01:31:21 -05:00
KiteStacks AutoSync
3cbb9248d8 Automated update: 2026-06-09 01:11:12 2026-06-09 01:11:12 -05:00
KiteStacks AutoSync
03c0729837 Automated update: 2026-06-09 00:50:48 2026-06-09 00:50:48 -05:00
KiteStacks AutoSync
1664c6a2a1 Automated update: 2026-06-09 00:30:13 2026-06-09 00:30:13 -05:00
KiteStacks AutoSync
0bad9d1109 Automated update: 2026-06-09 00:09:44 2026-06-09 00:09:44 -05:00
KiteStacks AutoSync
19e1744330 docs(discord): define recent activity feed workflow 2026-06-09 00:00:10 -05:00
KiteStacks AutoSync
e5429731f3 feat(discord): add Discord Integration project documentation 2026-06-08 23:57:34 -05:00
KiteStacks AutoSync
9a501cce3d Automated update: 2026-06-08 23:48:23 2026-06-08 23:48:23 -05:00
KiteStacks AutoSync
abbee480b5 Automated update: 2026-06-08 23:28:16 2026-06-08 23:28:16 -05:00
KiteStacks AutoSync
86cad9ae71 Automated update: 2026-06-08 23:08:11 2026-06-08 23:08:11 -05:00
KiteStacks AutoSync
318136e8a0 Automated update: 2026-06-08 22:47:39 2026-06-08 22:47:39 -05:00
KiteStacks AutoSync
272480bd80 Automated update: 2026-06-08 22:27:22 2026-06-08 22:27:22 -05:00
KiteStacks AutoSync
f98123b859 Automated update: 2026-06-08 22:06:43 2026-06-08 22:06:43 -05:00
KiteStacks AutoSync
90d7e82e10 Automated update: 2026-06-08 21:46:38 2026-06-08 21:46:38 -05:00
KiteStacks AutoSync
2c2faea3d8 Automated update: 2026-06-08 21:26:09 2026-06-08 21:26:09 -05:00
KiteStacks AutoSync
3e059ca69b Automated update: 2026-06-08 21:05:43 2026-06-08 21:05:43 -05:00
KiteStacks AutoSync
18dfd5d012 Automated update: 2026-06-08 20:45:10 2026-06-08 20:45:10 -05:00
Kenpat7177
34ae9423ef docs: complete Authentik SSO setup for all kitestacks.com services (v1.3.898)
- All OAuth2/OIDC providers created in Authentik; secrets filled for Kavita and OpenProject
- Proxy Providers created for Shaarli, Uptime Kuma, LiteLLM; assigned to Embedded Outpost
- OpenProject upgraded v13→v15 with data preserved; compose volume path fixed
- Cloudflare tunnel updates for proxy services still pending

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-08 20:32:51 -05:00