Skip to main content

Firecrawl

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.

Overview​

Firecrawl is a search-and-scrape API built for AI applications. As an Open WebUI web search engine it runs your query, returns ranked results and pulls the page content back in a clean, model-ready form. You can use the hosted service at api.firecrawl.dev, or point Open WebUI at a self-hosted Firecrawl instance since Firecrawl is open source, which keeps every query in-house.

Prerequisites​

  • Open WebUI Installed: A running instance of Open WebUI (local or Docker).
  • Firecrawl API key: From the hosted service at firecrawl.dev, or from your own self-hosted Firecrawl deployment.
  • Admin Access: Administrative access to your Open WebUI instance.

Configuration​

  1. Get an API key:
    • Hosted: sign up at firecrawl.dev and copy the key from your dashboard.
    • Self-hosted: use the key from your own Firecrawl instance.
  2. In Open WebUI, open Settings > Admin > Tools > Web Search.
  3. Toggle Enable Web Search on.
  4. Select Firecrawl from the Web Search Engine dropdown (engine value firecrawl).
  5. Paste your key into the Firecrawl API Key field.
  6. (Self-hosted only) Set the Firecrawl API Base URL to your instance, for example https://firecrawl.example.com. The default is https://api.firecrawl.dev.
  7. Save.

Then start a chat, enable web search with the + button in the prompt field, and run a query to confirm Firecrawl returns results.

Environment Variables​

You can configure Firecrawl with environment variables instead of, or alongside, the Admin Panel:

VariableDefaultPurpose
WEB_SEARCH_ENGINE(empty)Set to firecrawl to select this engine.
ENABLE_WEB_SEARCHfalseSet to true to turn web search on.
FIRECRAWL_API_KEY(empty)Your Firecrawl API key.
FIRECRAWL_API_BASE_URLhttps://api.firecrawl.devAPI endpoint. Point this at a self-hosted instance to keep queries in-house.
FIRECRAWL_TIMEOUT(Firecrawl default)Request timeout in milliseconds.

See the Environment Configuration reference for the full list of web-search variables.

Troubleshooting​

  • Invalid API Key: Confirm the key is copied without extra spaces, and that it matches the endpoint (a hosted key for api.firecrawl.dev, an instance key for self-hosted).
  • No Results: Make sure the web search toggle (+) is on and the instance can reach the Firecrawl endpoint.
  • Timeouts: Raise FIRECRAWL_TIMEOUT for slow pages or scrape-heavy queries.
  • Self-hosted connection errors: Verify FIRECRAWL_API_BASE_URL is reachable from the Open WebUI container or host.

Additional Resources​

This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.