# SearchXNG Context

Last updated: 2026-03-13 05:27:14 UTC

## Homelab placement

- Cluster: `sethpc`
- SearXNG:
  - CT: `119`
  - Node: `pve173`
  - URL: `https://searxng.sethpc.xyz` and `https://search.sethpc.xyz`
  - Config: `/etc/searxng/settings.yml`
- SethSearch API:
  - CT: `620`
  - Node: `pve173`
  - URL: `https://sethsearch.sethpc.xyz`
  - Service: `sethsearch.service`
  - App path: `/opt/sethsearch/sethsearch.py`
  - Config: `/opt/sethsearch/config.json`
- Caddy:
  - CT: `600`
  - Node: `pve241`
  - Config: `/etc/caddy/Caddyfile`

## Search engines in use

- `sethsearch` (`shortcut: ss`, category: `general`)
  - URL: `https://sethsearch.sethpc.xyz/search?q={query}&source=general&limit=40`
  - Weight: `5.0`
- `sethflix` (`shortcut: sfx`, category: `videos`)
  - URL: `https://sethsearch.sethpc.xyz/search?q={query}&source=sethflix&limit=40`
  - Weight: `5.0`
- `libretranslate` (`shortcut: lt`)
  - Base URL: `https://translate.sethpc.xyz`

## SethSearch sources

- `sites`: Caddy host/domain catalog with tags.
- `gitea`: public repositories.
- `wikijs`: public crawl/fallback page catalog.
- `wordpress`: public pages/posts from `sethfreiberg.com`.
- `emby`: media discovery index (links require account session).
- `freshrss`: article index with stricter matching and lower weight.

## Matching policy

- General (`source=general`): includes Emby with stricter matching.
- Sethflix (`source=sethflix`): Emby only with liberal matching.
- FreshRSS: strict term matching and lower source weight.

## API endpoints

- Health: `GET /health`
- Search: `GET /search?q=<query>&source=<group|source>&limit=<n>`
- Stats: `GET /stats`
- Manual sync: `POST /sync`