diff --git a/DEBUG-DOCUMENTATION.md b/DEBUG-DOCUMENTATION.md new file mode 100644 index 0000000..141286f --- /dev/null +++ b/DEBUG-DOCUMENTATION.md @@ -0,0 +1,26 @@ +# KiteStacks Homelab Debug Documentation + +## 2026-06-09 — Root CHANGELOG Permission Issue + +Problem: CHANGELOG.md could not be read by the normal user. + +Cause: CHANGELOG.md was owned by root and had 600 permissions. + +Fix: +sudo chown kenpat:kenpat CHANGELOG.md +chmod 644 CHANGELOG.md + +## 2026-06-09 — Repo Folder Ownership Issue + +Problem: The repo root folder was owned by root, which prevented creating RUNBOOK.md. + +Fix: +sudo chown -R kenpat:kenpat /opt/kitestacks-autosync/kitestacks-homelab + +## 2026-06-09 — Autosync Changelog Pollution + +Problem: CHANGELOG.md contains noisy autosync entries from live app/database files. + +Examples: apps/authentik/postgres, apps/forgejo/data, apps/grafana/data, journal files, pg_wal files. + +Next step: Review autosync excludes so database/session/cache/journal files are not committed or added to changelogs. diff --git a/RUNBOOK.md b/RUNBOOK.md new file mode 100644 index 0000000..87984c2 --- /dev/null +++ b/RUNBOOK.md @@ -0,0 +1,37 @@ +# KiteStacks Homelab Runbook + +## Purpose + +This repository documents the KiteStacks homelab. + +## Documentation Standard + +Each major repo or project should have RUNBOOK.md, CHANGELOG.md, and DEBUG-DOCUMENTATION.md. + +## Main Host + +Primary host: Assassin + +Main repo: /opt/kitestacks-autosync/kitestacks-homelab + +## Public URLs + +- https://www.kitestacks.com +- https://gitforge.kitestacks.com +- https://auth.kitestacks.com + +## Discord Integration + +Project docs live in projects/Discord Integration/. + +Recent activity channel: #recent-activity + +Webhook env file: /etc/kitestacks/discord-webhook.env + +Activity script: /usr/local/bin/kitestacks-discord-activity.sh + +Do not commit webhook URLs, tokens, secrets, database files, sessions, or live container data. + +## Known Issue + +The root CHANGELOG.md was generated by autosync and includes live app/database file changes.