mirror of
https://github.com/searxng/searxng.git
synced 2025-07-09 03:04:26 -04:00
* [mod] container: replace uWSGI with Granian The configuration in Granian is handled with ENVs, much more convenient and practical for updating. The settings have been tested for over two months in a production instance, being usable on small to somewhat large instances without having to modify anything. It also removes the patch functions and ENVs abstraction from the entrypoint, this makes it possible to run the container with immutable configuration. In some setups, It may be desired to have the volumes/files under a specific uid/gid (other than searxng:searxng), if the entrypoint has root permissions it will chown automatically on every start, which may not be desired. Explicitly setting the new ENV `FORCE_OWNERSHIP=false` will prevent ownership from being modified. No manual migration is necessary **unless** the user has changed the default uWSGI configuration or has a very specific setup. Closes https://github.com/searxng/searxng/issues/4894 Closes https://github.com/searxng/searxng/issues/4818 Closes https://github.com/searxng/searxng/issues/4802 Supersedes https://github.com/searxng/searxng/pull/4596 Related https://github.com/searxng/searxng/discussions/4479 * [mod] docs: add container/granian All container documentation has been recreated. A new documentation page has been created for Granian. * [enh] misc: apply suggestions Minor documentation changes. Suggested https://github.com/searxng/searxng/pull/4820#discussion_r2134539259 Suggested https://github.com/searxng/searxng/pull/4820#discussion_r2134538610 Suggested https://github.com/searxng/searxng/pull/4820#discussion_r2134827964 Suggested https://github.com/searxng/searxng/pull/4820#discussion_r2134544300 Suggested https://github.com/searxng/searxng/pull/4820#discussion_r2149387388 --------- Signed-off-by: Markus Heiser <markus.heiser@darmarit.de> Co-authored-by: Ivan Gabaldon <igabaldon@inetol.net> Co-authored-by: Markus Heiser <markus.heiser@darmarit.de>
23 lines
734 B
ReStructuredText
23 lines
734 B
ReStructuredText
.. _installation:
|
|
|
|
============
|
|
Installation
|
|
============
|
|
|
|
*You're spoilt for choice*, choose your preferred method of installation.
|
|
|
|
- :ref:`installation container`
|
|
- :ref:`installation scripts`
|
|
- :ref:`installation basic`
|
|
|
|
The :ref:`installation basic` is an excellent illustration of *how a SearXNG
|
|
instance is build up* (see :ref:`architecture uWSGI`). If you do not have any
|
|
special preferences, it's recommended to use the :ref:`installation container` or the
|
|
:ref:`installation scripts`.
|
|
|
|
.. attention::
|
|
|
|
SearXNG is growing rapidly, you should regularly read our :ref:`migrate and
|
|
stay tuned` section. If you want to upgrade an existing instance or migrate
|
|
from searx to SearXNG, you should read this section first!
|