.. _settings server: =========== ``server:`` =========== .. code:: yaml server: base_url: http://example.org/location # change this! port: 8888 bind_address: "127.0.0.1" secret_key: "ultrasecretkey" # change this! limiter: false public_instance: false image_proxy: false method: "GET" default_http_headers: X-Content-Type-Options : nosniff X-Download-Options : noopen X-Robots-Tag : noindex, nofollow Referrer-Policy : no-referrer ``base_url`` : ``$SEARXNG_URL`` The base URL where SearXNG is deployed. Used to create correct inbound links. ``port`` & ``bind_address``: ``$SEARXNG_PORT`` & ``$SEARXNG_BIND_ADDRESS`` Port number and *bind address* of the SearXNG web application if you run it directly using ``python searx/webapp.py``. Doesn't apply to a SearXNG services running behind a proxy and using socket communications. ``secret_key`` : ``$SEARXNG_SECRET`` Used for cryptography purpose. ``limiter`` : ``$SEARXNG_LIMITER`` Rate limit the number of request on the instance, block some bots. The :ref:`limiter` requires a :ref:`settings redis` database. .. _public_instance: ``public_instance`` : ``$SEARXNG_PUBLIC_INSTANCE`` Setting that allows to enable features specifically for public instances (not needed for local usage). By set to ``true`` the following features are activated: - :py:obj:`searx.botdetection.link_token` in the :ref:`limiter` .. _image_proxy: ``image_proxy`` : ``$SEARXNG_IMAGE_PROXY`` Allow your instance of SearXNG of being able to proxy images. Uses memory space. ``method`` : ``GET`` | ``POST`` HTTP method. By defaults ``GET`` is used / The ``POST`` method has the advantage with some WEB browsers that the history is not easy to read, but there are also various disadvantages that sometimes severely restrict the ease of use for the user (e.g. back button to jump back to the previous search page and drag & drop of search term to new tabs do not work as expected). .. _HTTP headers: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers ``default_http_headers`` : Set additional HTTP headers, see `#755 `__