Reorganize docs by project and archive legacy context files

This commit is contained in:
2026-03-13 05:47:23 +00:00
parent 8d323c9393
commit 99df060f51
13 changed files with 132 additions and 20 deletions
+14 -20
View File
@@ -1,28 +1,22 @@
# SearchXNG Project
Unified workspace for:
This repo is now organized by project area.
- `searchxng/`: SearXNG settings, engine wiring, and instance branding context.
- `api/`: SethSearch API context, indexing rules, and source integration details.
- `context/`: operational runbooks and architecture docs.
## Layout
## Stack
- `projects/searchxng/`: SearXNG integration, engine wiring, and service context.
- `projects/sethsearch-api/`: SethSearch indexer/API behavior, source rules, and maintenance.
- `projects/shared/`: cross-cutting architecture and operations runbooks.
- `archive/legacy-context-2026-03-13/`: archived first-pass context docs.
- SearXNG instance: `searxng.sethpc.xyz` / `search.sethpc.xyz` (CT 119 on `pve173`)
- SethSearch API: `sethsearch.sethpc.xyz` (CT 620 on `pve173`)
- Reverse proxy: Caddy CT 600 (`pve241`)
## Live stack
## Key behavior
- SearXNG: `https://searxng.sethpc.xyz` and `https://search.sethpc.xyz` (CT 119, `pve173`)
- SethSearch API: `https://sethsearch.sethpc.xyz` (CT 620, `pve173`)
- Caddy: CT 600 (`pve241`)
- `sethsearch` engine (general): searches homelab/site/content sources with strict FreshRSS and strict Emby matching.
- `sethflix` engine (videos): Emby-only search for media discovery.
- LibreTranslate integrated via `translate.sethpc.xyz`.
## Quick commands
## Quick Ops
- Restart SethSearch API:
- `ssh pve173 "pct exec 620 -- systemctl restart sethsearch"`
- Restart SearXNG:
- `ssh pve173 "pct exec 119 -- systemctl restart searxng"`
- Validate Caddy:
- `ssh pve241 "pct exec 600 -- caddy validate --config /etc/caddy/Caddyfile"`
- Restart SethSearch: `ssh pve173 "pct exec 620 -- systemctl restart sethsearch"`
- Restart SearXNG: `ssh pve173 "pct exec 119 -- systemctl restart searxng"`
- Validate Caddy: `ssh pve241 "pct exec 600 -- caddy validate --config /etc/caddy/Caddyfile"`