|
|
|
@ -37,10 +37,10 @@ see how you can simplify your *user defined* ``settings.yml``.
|
|
|
|
|
Global Settings
|
|
|
|
|
===============
|
|
|
|
|
|
|
|
|
|
.. _settings global brand:
|
|
|
|
|
.. _settings brand:
|
|
|
|
|
|
|
|
|
|
``brand:``
|
|
|
|
|
------------
|
|
|
|
|
----------
|
|
|
|
|
|
|
|
|
|
.. code:: yaml
|
|
|
|
|
|
|
|
|
@ -62,7 +62,7 @@ Global Settings
|
|
|
|
|
``wiki_url`` :
|
|
|
|
|
Link to your wiki (or ``false``)
|
|
|
|
|
|
|
|
|
|
.. _settings global general:
|
|
|
|
|
.. _settings general:
|
|
|
|
|
|
|
|
|
|
``general:``
|
|
|
|
|
------------
|
|
|
|
@ -85,7 +85,60 @@ Global Settings
|
|
|
|
|
Enabled by default. Record various anonymous metrics availabled at ``/stats``,
|
|
|
|
|
``/stats/errors`` and ``/preferences``.
|
|
|
|
|
|
|
|
|
|
.. _settings global server:
|
|
|
|
|
.. _settings search:
|
|
|
|
|
|
|
|
|
|
``search:``
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
.. code:: yaml
|
|
|
|
|
|
|
|
|
|
search:
|
|
|
|
|
safe_search: 0
|
|
|
|
|
autocomplete: ""
|
|
|
|
|
default_lang: ""
|
|
|
|
|
ban_time_on_fail: 5
|
|
|
|
|
max_ban_time_on_fail: 120
|
|
|
|
|
formats:
|
|
|
|
|
- html
|
|
|
|
|
|
|
|
|
|
``safe_search``:
|
|
|
|
|
Filter results.
|
|
|
|
|
|
|
|
|
|
- ``0``: None
|
|
|
|
|
- ``1``: Moderate
|
|
|
|
|
- ``2``: Strict
|
|
|
|
|
|
|
|
|
|
``autocomplete``:
|
|
|
|
|
Existing autocomplete backends, leave blank to turn it off.
|
|
|
|
|
|
|
|
|
|
- ``dbpedia``
|
|
|
|
|
- ``duckduckgo``
|
|
|
|
|
- ``google``
|
|
|
|
|
- ``startpage``
|
|
|
|
|
- ``swisscows``
|
|
|
|
|
- ``qwant``
|
|
|
|
|
- ``wikipedia``
|
|
|
|
|
|
|
|
|
|
``default_lang``:
|
|
|
|
|
Default search language - leave blank to detect from browser information or
|
|
|
|
|
use codes from :origin:`searx/languages.py`.
|
|
|
|
|
|
|
|
|
|
``ban_time_on_fail``:
|
|
|
|
|
Ban time in seconds after engine errors.
|
|
|
|
|
|
|
|
|
|
``max_ban_time_on_fail``:
|
|
|
|
|
Max ban time in seconds after engine errors.
|
|
|
|
|
|
|
|
|
|
``formats``:
|
|
|
|
|
Result formats available from web, remove format to deny access (use lower
|
|
|
|
|
case).
|
|
|
|
|
|
|
|
|
|
- ``html``
|
|
|
|
|
- ``csv``
|
|
|
|
|
- ``json``
|
|
|
|
|
- ``rss``
|
|
|
|
|
|
|
|
|
|
.. _settings server:
|
|
|
|
|
|
|
|
|
|
``server:``
|
|
|
|
|
-----------
|
|
|
|
@ -98,8 +151,6 @@ Global Settings
|
|
|
|
|
bind_address: "127.0.0.1" # address to listen on
|
|
|
|
|
secret_key: "ultrasecretkey" # change this!
|
|
|
|
|
image_proxy: false # proxying image results through SearXNG
|
|
|
|
|
default_locale: "" # default interface locale
|
|
|
|
|
default_theme: oscar # ui theme
|
|
|
|
|
default_http_headers:
|
|
|
|
|
X-Content-Type-Options : nosniff
|
|
|
|
|
X-XSS-Protection : 1; mode=block
|
|
|
|
@ -128,6 +179,26 @@ Global Settings
|
|
|
|
|
``image_proxy`` :
|
|
|
|
|
Allow your instance of SearXNG of being able to proxy images. Uses memory space.
|
|
|
|
|
|
|
|
|
|
.. _HTTP headers: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers
|
|
|
|
|
|
|
|
|
|
``default_http_headers``:
|
|
|
|
|
Set additional HTTP headers, see `#755 <https://github.com/searx/searx/issues/715>`__
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. _settings ui:
|
|
|
|
|
|
|
|
|
|
``ui:``
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
.. code:: yaml
|
|
|
|
|
|
|
|
|
|
ui:
|
|
|
|
|
default_locale: ""
|
|
|
|
|
query_in_title: false
|
|
|
|
|
default_theme: simple
|
|
|
|
|
theme_args:
|
|
|
|
|
simple_style: auto
|
|
|
|
|
|
|
|
|
|
``default_locale`` :
|
|
|
|
|
SearXNG interface language. If blank, the locale is detected by using the
|
|
|
|
|
browser language. If it doesn't work, or you are deploying a language
|
|
|
|
@ -137,10 +208,15 @@ Global Settings
|
|
|
|
|
``default_theme`` :
|
|
|
|
|
Name of the theme you want to use by default on your SearXNG instance.
|
|
|
|
|
|
|
|
|
|
.. _HTTP headers: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers
|
|
|
|
|
``theme_args.simple_style``:
|
|
|
|
|
Style of simple theme: ``auto``, ``light``, ``dark``
|
|
|
|
|
|
|
|
|
|
``default_http_headers``:
|
|
|
|
|
Set additional HTTP headers, see `#755 <https://github.com/searx/searx/issues/715>`__
|
|
|
|
|
``query_in_title``:
|
|
|
|
|
When true, the result page's titles contains the query it decreases the
|
|
|
|
|
privacy, since the browser can records the page titles.
|
|
|
|
|
|
|
|
|
|
``results_on_new_tab``:
|
|
|
|
|
Open result links in a new tab by default.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. _settings redis:
|
|
|
|
@ -374,8 +450,9 @@ engine is shown. Most of the options have a default value or even are optional.
|
|
|
|
|
``network``: optional
|
|
|
|
|
Use the network configuration from another engine.
|
|
|
|
|
In addition, there are two default networks:
|
|
|
|
|
* ``ipv4`` set ``local_addresses`` to ``0.0.0.0`` (use only IPv4 local addresses)
|
|
|
|
|
* ``ipv6`` set ``local_addresses`` to ``::`` (use only IPv6 local addresses)
|
|
|
|
|
|
|
|
|
|
- ``ipv4`` set ``local_addresses`` to ``0.0.0.0`` (use only IPv4 local addresses)
|
|
|
|
|
- ``ipv6`` set ``local_addresses`` to ``::`` (use only IPv6 local addresses)
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
|
|
|
|
|