stack/AGENTS.md
tim 0108868a2c Document all post-secret-change update procedures
Add a single quickstart table covering Cloudflare DDNS, Usenet, NZBgeek,
WireGuard, stack .env, and bootstrap; point secrets/.env.example and
AGENTS.md at the same workflow.
2026-07-22 19:48:56 -07:00

976 B

Agent notes (arr-stack)

Git

  • Remote: originssh://git@192.168.8.123:2222/tim/stack.git (Forgejo tim/stack)
  • After any meaningful change set: commit and push to main with a clear, complete-sentence message (what changed and why).
  • Never commit secrets: .env, wireguard/wg0.conf, config/, GGUF models, ansible/.secrets/.
  • Prefer SSH push (GIT_SSH_COMMAND with ~/.ssh/id_ed25519 if needed).
  • Server checkout: /opt/stack is the same repo (git pull on ser5). Ansible uses stack_deploy_method: git.
  • Prefer .env for config (see .env.example). Demo creds: DEMO_USER=tim DEMO_PASS=asdfasdf. Fresh host: ./scripts/bootstrap-stack.sh.
  • Secrets live in secrets/.env (gitignored). After edits: see quickstart.md → After changing secrets (Usenet → configure-usenet.sh; Cloudflare → render-cloudflare-ddns-env.sh + recreate container; NZBgeek → Prowlarr UI; WireGuard → wg0.conf + gluetun recreate/watch).