reference configuration

Configuration reference

Environment variables

Variable	Required	Default	Description
ENGINE_BRAVE_API_KEY	Yes		Brave Search API key
ENGINE_GITHUB_TOKEN	Yes		GitHub personal access token
ENGINE_HUGGINGFACE_API_KEY	No		HuggingFace API token
ENGINE_STACKEXCHANGE_API_KEY	No		Stack Exchange API key
ENGINE_SEMANTICSCHOLAR_API_KEY	No		Semantic Scholar API key
SEARCH_CACHE_TTL_SECONDS	No	300	Global cache TTL in seconds
SEARCH_LOG_LEVEL	No	INFO	Log level (DEBUG, INFO, WARNING, ERROR)
SEARCH_DEFAULT_ENGINES	No	all	Comma-separated list of default engines
VALKEY_URL	No	valkey://localhost:6379	Valkey or Redis connection string

Config file format

SlopSearX reads configuration from /etc/slopsearx/config.yaml. Environment variables override values in this file.

Example

# /etc/slopsearx/config.yaml

cache:
  ttl_seconds: 300

log:
  level: INFO

default_engines:
  - brave
  - duckduckgo
  - wikipedia

valkey:
  url: "valkey://valkey:6379"

engines:
  brave:
    api_key: "${ENGINE_BRAVE_API_KEY}"
  github:
    token: "${ENGINE_GITHUB_TOKEN}"
  huggingface:
    api_key: "${ENGINE_HUGGINGFACE_API_KEY}"
  stackexchange:
    api_key: "${ENGINE_STACKEXCHANGE_API_KEY}"
  semanticscholar:
    api_key: "${ENGINE_SEMANTICSCHOLAR_API_KEY}"