Repository navigation
SearXNG Setup Guide
Andy Gillis edited this page Nov 17, 2026
·
3 revisions
SearXNG is a private metasearch engine: it sends your query to several search engines and merges the results, with no account or API key. Here it gives OpenWebUI Setup Guide (WSL2 Docker) its web search, so the local model can look things up.
compose/server2/searxng.yaml:
services:
searxng:
container_name: searxng.${HOST_NAME}
image: searxng/searxng:2026.11.2-cccbc9e15 # pinned; update by hand
environment:
TZ: ${TZ}
SEARXNG_BASE_URL: http://searxng.${HOST_NAME}:8080/
ports:
- "127.0.0.1:${SEARXNG_PORT}:8080" # only Open WebUI uses it
volumes:
- ${COMPOSE_DIR}/searxng/settings.yml:/etc/searxng/settings.yml:ro
restart: alwaysOpen WebUI needs JSON results, which SearXNG disables by default:
use_default_settings: true
server:
secret_key: "<random string>" # e.g. openssl rand -hex 32; set via SEARXNG_SECRET
limiter: false # private instance, one client
search:
formats:
- html
- jsonAdmin Panel → Settings → Web Search: engine searxng, query URL http://searxng.<host>:8080/search?q=<query>.
- Queries go out from your own IP address. Heavy use can get you temporarily rate-limited by an engine; SearXNG just skips that engine for a while.
- Test it directly:
curl "http://127.0.0.1:<port>/search?q=test&format=json"should return JSON. A403means the JSON format isn't enabled.