Skip to main content

Yandex

warning

This tutorial is a community contribution and is not supported by the Open WebUI team. It serves only as a demonstration on how to customize Open WebUI for your specific use case. Want to contribute? Check out the contributing tutorial.

tip

For a comprehensive list of all environment variables related to Web Search (including concurrency settings, result counts, and more), please refer to the Environment Configuration documentation.

Troubleshooting

Having issues with web search? Check out the Web Search Troubleshooting Guide for solutions to common problems like proxy configuration, connection timeouts, and empty content.

Yandex Search API​

Support for Yandex Web Search is integrated via the Yandex Cloud Search API.

Docker Compose Setup​

Add the following environment variables to your Open WebUI docker-compose.yaml file:

services:
  open-webui:
    environment:
      ENABLE_RAG_WEB_SEARCH: True
      RAG_WEB_SEARCH_ENGINE: "yandex"
      YANDEX_WEB_SEARCH_API_KEY: "YOUR_YANDEX_CLOUD_API_KEY"
      # Optional: Override default search URL
      # YANDEX_WEB_SEARCH_URL: "https://searchapi.api.cloud.yandex.net/v2/web/search"
      # Optional: Custom JSON configuration for Yandex Search API
      # YANDEX_WEB_SEARCH_CONFIG: '{"query": {"searchType": "SEARCH_TYPE_RU"}}'

Configuration Options​

  • YANDEX_WEB_SEARCH_URL: The endpoint for the Yandex Search API. Defaults to https://searchapi.api.cloud.yandex.net/v2/web/search.
  • YANDEX_WEB_SEARCH_API_KEY: Your Yandex Cloud API Key.
  • YANDEX_WEB_SEARCH_CONFIG: An optional JSON string to customize the search request. This allows you to set any parameters supported by the Yandex Search API.