Files

T

Frank 5829a0bfe8 docs: rename docs/ -> serverAppConfigs-docs/ per system-wide PROJECTNAME-docs convention

All in-repo path references (AGENTS.md, README, old scripts, report artifacts,
test code paths) rewritten in the same commit; focused-test map extended for
.gitignore, old/scripts/*, dankclaw/comfyui/*, and report/* per this repo's
own convention ('add one before committing'). Obsidian wikilinks are
title-based and unaffected.

2026-08-28 02:20:06 -07:00

1.5 KiB

Raw Blame History

Valkey

Valkey is the cache and limiter store for SearXNG. It replaces Redis as the default in the official SearXNG deployment.

Host: Dankclaw — Docs: https://valkey.io

Facts (from research)

Item	Value
Image	`valkey/valkey:9-alpine`
Port	6379 (internal, on the SearXNG network)
Role	SearXNG limiter + result cache

Why Valkey

The official SearXNG docker-compose ships a searxng-valkey container. Valkey is the Redis fork under the Linux Foundation umbrella; the SearXNG project moved to it as the default cache.

Configuration

The valkey unit is searxng-valkey.container (see SearXNG for the trio). It joins the searxng network and is reachable by the name searxng-valkey (container name) and the alias valkey:

[Container]
ContainerName=searxng-valkey
Network=searxng.network
NetworkAlias=valkey
Image=docker.io/valkey/valkey:9-alpine
Volume=/opt/searxng/valkey:/data

SearXNG connects to it via settings.yml:

valkey:
  url: "valkey://searxng-valkey:6379/0"

It sets WantedBy=default.target. User linger is on, so it starts at boot.

Volumes

Container path	Host path (convention)
`/data`	`/opt/searxng/valkey`

Gotchas

The limiter relies on Valkey; without it SearXNG falls back to in-memory state and rate limiting is per-restart.
Keep Valkey on the same podman network as SearXNG.

1.5 KiB Raw Blame History