docs(security): Linux host-agent fallback is 127.0.0.1 post-#988#1017
docs(security): Linux host-agent fallback is 127.0.0.1 post-#988#1017yasinBursali wants to merge 3 commits intoLight-Heart-Labs:mainfrom
Conversation
|
Re-marking as draft as a mechanical merge-order safeguard. This branch contains commits Merge order: #973 first, then this PR rebases clean and gets re-marked ready. |
|
Audit follow-up: keep draft and rebase to a docs-only delta. #988 has now landed, so the security-doc direction is right, but this branch is currently draft/conflicting and still carries part of the old code/docs stack. Please rebase on current |
Fix stale, contradictory, and missing documentation identified by a systematic audit of the last 50 merged PRs against all existing docs. Fixes: - WINDOWS-QUICKSTART.md: remove "Coming Soon" language, add real install flow, commands, and verified installer flags - MODE-SWITCH.md: add lemonade mode section (auto-configured on AMD) - QUICKSTART.md / README.md: update all Qwen2.5 model names to Qwen3.5/Qwen3 to match current tier-map.sh - POST-INSTALL-CHECKLIST.md: rewrite skeleton with real verification commands - Root README.md: fix Apple Silicon "4B" → "9B" for 16-24GB tier Additions: - SECURITY.md: DREAM_AGENT_BIND / LAN access section - FAQ.md: backup/restore, service templates, bootstrap fast-start, expanded update/rollback documentation - HOST-AGENT-API.md: Windows platform limitation note - CATALOG.md: add missing Langfuse entry - Langfuse README.md: new service README with full configuration, env vars, volumes, and troubleshooting - .env.example: document LLAMA_CPU_LIMIT for macOS/CPU-only mode - SUPPORT-MATRIX.md: link to AMD system-tuning guide Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
… on Windows The prior commit in this PR added two Windows entries to HOST-AGENT-API.md based on the docs state at the time the sync was drafted. Windows host agent support shipped via the fix/windows-host-agent-startup branch before this PR's work began, so the 'not yet available' row and the 'dream.ps1 restart' workaround blockquote describe out-of-date behavior. Replaces the table row with the accurate mechanism and removes the workaround blockquote.
…rt-Labs#988 fix/security-loopback (Light-Heart-Labs#988) changes the Linux Docker-bridge-gateway detection fallback in bin/dream-host-agent.py from 0.0.0.0 to 127.0.0.1 (security fix: prevents LAN exposure when bridge detection fails). docs/sync-documentation-with-codebase (Light-Heart-Labs#973) adds the Host Agent Network Binding table whose Linux row documented pre-Light-Heart-Labs#988 behavior — the 0.0.0.0 fallback language is now stale. Updates the Linux row to match the actual fallback. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
afea9cc to
ce676b9
Compare
|
Pushed audit follow-up — rebased onto current The audit ("rebase to a docs-only delta after #988") needed clarification because of an interaction with the still-open #973: SECURITY.md on current
If #973 merges before this PR, the rebase will trivially collapse the first two commits (their SECURITY.md additions are already on main) and leave just the 1-line correction on the third commit ( Suggested merge order to minimise rebase friction: #973 first, then #1017. I will update #973 in this same session to use |
fix/security-loopback) changes the Linux Docker-bridge-gateway detection fallback inbin/dream-host-agent.pyfrom0.0.0.0to127.0.0.1.docs/sync-documentation-with-codebase) introduces the "Host Agent Network Binding" table inSECURITY.mdwhose Linux row documents pre-fix(security): bind llama-server and host agent to loopback #988 behavior.Once both merge, I'll rebase and the PR diff will show exactly the 1-line change below.
What
One-cell docs edit in the "Host Agent Network Binding" table in
dream-server/SECURITY.md, Linux row:Why
#973's Linux row was accurate when written but becomes stale the moment #988 merges. Actual runtime behavior per
bin/dream-host-agent.py:2241:bind_addr = _detect_docker_bridge_gateway() or "127.0.0.1". Docs should match.Testing
bin/dream-host-agent.py0.0.0.0mentions are legitimate user-opt-in override examples)Platform Impact