.. _searxng granian:

======= Granian

.. _Options: https://github.com/emmett-framework/granian/blob/master/README.md#options .. _Workers and threads: https://github.com/emmett-framework/granian/blob/master/README.md#workers-and-threads .. _Backpressure: https://github.com/emmett-framework/granian/blob/master/README.md#backpressure .. _Runtime mode: https://github.com/emmett-framework/granian/blob/master/README.md#runtime-mode

.. sidebar:: further reading

• Options_
• Workers and threads_
• Backpressure_
• Runtime mode_

.. note::

Granian will be the future replacement for :ref:searxng uwsgi in SearXNG. At the moment, it's only officially supported in the :ref:installation container.

.. _Granian installation:

Installation

We only recommend installing Granian with pip, as officially documented. Run the following command in the Python environment of the SearXNG installation:

.. code:: sh

$ pip install granian

.. _Granian configuration:

Configuration

.. note::

It's not advised to modify the amount of workers, expect increased resource usage and potential issues with :ref:botdetection.

Granian can be configured via option parameters and environment variables ($GRANIAN_*).

We provide sane defaults that should fit most use cases, however if you feel you should change something, Granian documents all available parameters in the Options_ section.