Skip to content

🔍 docs: Document SearXNG Search Options - #732

Merged
berry-13 merged 2 commits into
mainfrom
docs/searxng-search-options
Aug 21, 2026
Merged

berry-13 merged 2 commits into
mainfrom
docs/searxng-search-options

Conversation

@berry-13

Copy link
Copy Markdown
Collaborator

Summary

Documents the searxngSearchOptions block for web search, which had no coverage in the docs.

  • Full reference for searxngSearchOptions and its subkeys (engines, language, timeRange, timeout), including accepted types, defaults, and the @librechat/agents version it needs
  • A "Choosing engines" section explaining that engine names are instance-specific, that SearXNG silently skips names it does not recognize, and why the default set (which includes DuckDuckGo) tends to return nothing on self-hosted instances
  • A short "What these options do not control" list so readers do not go looking for safe search, categories, page number, or result format in this block
  • A troubleshooting section for empty SearXNG results, ordered by how often each cause shows up, with a curl command that reproduces the request LibreChat sends
  • A YAML equivalent of the existing UI-based SearXNG setup walkthrough
  • Cross-links from the feature page so the SearXNG setup steps and the provider comparison point at the new reference

Change Type

  • Documentation update

Testing

  • npx prettier --check on both changed files: passes

Checklist

  • My code adheres to this project's style guidelines
  • I have performed a self-review of my own code
  • Local unit tests pass with my changes

Add reference coverage for the searxngSearchOptions block (engines,
language, timeRange, timeout), guidance on picking engines that work on
self-hosted instances, and a troubleshooting section for searches that
come back empty.
@vercel

vercel Bot commented Aug 21, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
librechat-ai Ready Ready Preview Aug 21, 2026 4:03pm

Request Review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 25c2d7a4b1

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread content/docs/configuration/librechat_yaml/object_structure/web_search.mdx Outdated
@github-actions

Copy link
Copy Markdown
Contributor

📦 Next.js Bundle Analysis for librechat.ai

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

…ilures

The YAML setup example pointed at a loopback SearXNG URL without the
matching allowedAddresses entry, so the connect-time guard would block it
even with a healthy instance. Add the exemption, cover the Docker case
where localhost is the LibreChat container, and list the missing
exemption first in the troubleshooting steps.

Also correct the claim that a CAPTCHA'd DuckDuckGo empties the response.
SearXNG merges whatever the selected engines return, so an empty result
set means every selected engine failed.
@github-actions

Copy link
Copy Markdown
Contributor

📦 Next.js Bundle Analysis for librechat.ai

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

@berry-13
berry-13 merged commit 336389e into main Aug 21, 2026
6 checks passed
@berry-13
berry-13 deleted the docs/searxng-search-options branch August 21, 2026 16:13

This branch was successfully deployed

1 active deployment
Preview — 53a079c4 Deployed Aug 21, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant