← Back to all projects

SearXNG

Self-hosted metasearch — web search for an agent with no API key and no per-query bill

OfficialAGPL-3.0
Stars
36.2k
Forks
3.3k
Open issues
218
Last commit
28 Aug 2026

What is SearXNG?

It keeps no index of its own; a query is fanned out to as many as 269 search services and the results are merged, which is how an agent gets web search without a commercial search API behind it. A JSON endpoint makes it usable from code rather than only from the browser. Two consequences follow from having no index: result quality and availability are inherited from the upstream engines, and when one of them starts blocking your instance that is your problem to solve.

What can you do with SearXNG?

  • Search the web without holding a key — There is no signup, no key to rotate and no per-query cost — the instance you run is the credential, which changes the economics of an agent that searches on every turn.
  • Get JSON instead of a page — A search API returns structured results, so a tool wrapper is a small HTTP call rather than an HTML scraper that breaks when the layout changes.
  • Merge many engines into one answer — Because results come from up to 269 services at once, coverage does not depend on any single provider's index or on its view of what your query meant.
  • Leave no profile behind — Users are neither tracked nor profiled, JavaScript and cookies are optional, and the instance can be run over Tor — relevant when the queries themselves are sensitive.
  • Deploy it the way you deploy everything else — Docker images, installation scripts and app servers including Granian, uWSGI, NGINX and Apache are all documented, with engines, caching and plugins configured in settings files.

Before you choose SearXNG

  • There is no index of its own, so both result quality and availability are inherited from the upstream engines — when one starts blocking or throttling your instance, working around it falls to you.
  • The AGPL reaches network use, so offering a modified instance as part of a service brings a source-provision obligation the permissive licences elsewhere in this category do not.
  • A self-hosted instance ships with a limiter and bot detection, which have to be configured deliberately before your own automated queries pass through reliably.

Star history

21 Aug to 28 Aug · +334

35.9k36.2k

Frequently asked questions

Is SearXNG free for commercial use?

SearXNG is released under the AGPL-3.0 licence — OSI-approved open source, which permits commercial use.

How can SearXNG be deployed?

SearXNG is available as Self-hosted / Runs locally.

Documentation

Reproduced from the searxng/searxng README, published under AGPL-3.0. Read the original ↗

.. SPDX-License-Identifier: AGPL-3.0-or-later

.. _metasearch engine: https://en.wikipedia.org/wiki/Metasearch_engine .. _Installation guide: https://docs.searxng.org/admin/installation.html .. _Configuration guide: https://docs.searxng.org/admin/settings/index.html .. _CONTRIBUTING: https://github.com/searxng/searxng/blob/master/CONTRIBUTING.rst .. _LICENSE: https://github.com/searxng/searxng/blob/master/LICENSE

.. figure:: https://raw.githubusercontent.com/searxng/searxng/master/client/simple/src/brand/searxng.svg :target: https://searxng.org :alt: SearXNG :width: 512px

SearXNG is a metasearch engine_. Users are neither tracked nor profiled.

.. image:: https://img.shields.io/badge/organization-3050ff?style=flat-square&logo=searxng&logoColor=fff&cacheSeconds=86400 :target: https://github.com/searxng :alt: Organization

.. image:: https://img.shields.io/badge/documentation-3050ff?style=flat-square&logo=readthedocs&logoColor=fff&cacheSeconds=86400 :target: https://docs.searxng.org :alt: Documentation

.. image:: https://img.shields.io/github/license/searxng/searxng?style=flat-square&label=license&color=3050ff&cacheSeconds=86400 :target: https://github.com/searxng/searxng/blob/master/LICENSE :alt: License

.. image:: https://img.shields.io/github/commit-activity/y/searxng/searxng/master?style=flat-square&label=commits&color=3050ff&cacheSeconds=3600 :target: https://github.com/searxng/searxng/commits/master/ :alt: Commits

.. image:: https://img.shields.io/weblate/progress/searxng?server=https%3A%2F%2Ftranslate.codeberg.org&style=flat-square&label=translated&color=3050ff&cacheSeconds=86400 :target: https://translate.codeberg.org/projects/searxng/ :alt: Translated

Setup

To install SearXNG, see Installation guide_.

To fine-tune SearXNG, see Configuration guide_.

Further information on how-to can be found here <https://docs.searxng.org/admin/index.html>_.

Connect

If you have questions or want to connect with others in the community:

  • #searxng:matrix.org <https://matrix.to/#/#searxng:matrix.org>_

Contributing

See CONTRIBUTING_ for more details.

License

This project is licensed under the GNU Affero General Public License (AGPL-3.0). See LICENSE_ for more details.