From 01be2612ab845771929181592931464f179357ea Mon Sep 17 00:00:00 2001 From: Ivan Gabaldon Date: Fri, 4 Jul 2025 14:35:28 +0200 Subject: [mod] container: replace uWSGI with Granian (#4820) * [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 Co-authored-by: Ivan Gabaldon Co-authored-by: Markus Heiser --- docs/admin/installation.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/admin/installation.rst') diff --git a/docs/admin/installation.rst b/docs/admin/installation.rst index 54d901f76..da603a639 100644 --- a/docs/admin/installation.rst +++ b/docs/admin/installation.rst @@ -6,13 +6,13 @@ Installation *You're spoilt for choice*, choose your preferred method of installation. -- :ref:`installation docker` +- :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 docker` or the +special preferences, it's recommended to use the :ref:`installation container` or the :ref:`installation scripts`. .. attention:: -- cgit v1.2.3