docs: clarify searxng local endpoint and fallback setup

2026-02-22 22:16:39 -08:00
parent f27aabae3b
commit eb81e68dd8
3 changed files with 29 additions and 1 deletions
@@ -490,6 +490,22 @@ Optional local SearXNG container (for self-hosted web search):
 docker compose --profile search up -d searxng
 ```

+Local-first + homelab fallback pattern:
+
+- If Flynn runs in Docker Compose, set `endpoint: "http://searxng:8080"`.
+- If Flynn runs on the host (`pnpm dev` / `pnpm start`), set `endpoint: "http://localhost:18803"`.
+- Set `fallback_endpoint` to your existing homelab SearXNG URL.
+
+Example for host-run Flynn with local compose SearXNG and homelab backup:
+
+```yaml
+web_search:
+  provider: searxng
+  endpoint: "http://localhost:18803"
+  fallback_endpoint: "https://searxng.homelab.local"
+  max_results: 5
+```
+
 Note: Flynn's built-in `web.search*` tools call Brave's HTTP API directly and use `web_search.api_key`; they do not route through the `brave-search` MCP container.

 ### Text-to-Speech (TTS) Reply Audio