[doc] build from commit cf74e1d9e9

_sources/admin/installation-granian.rst.txt

@@ -0,0 +1,52 @@
+.. _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.