kitestacks-homelab/DEBUG-DOCUMENTATION.md
2026-06-09 03:32:33 -05:00

851 B

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.