mirror of
https://github.com/searxng/searxng.git
synced 2025-07-09 03:04:26 -04:00
01be2612ab
* [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>
62 lines
1.8 KiB
ReStructuredText
62 lines
1.8 KiB
ReStructuredText
.. _installation scripts:
|
|
|
|
===================
|
|
Installation Script
|
|
===================
|
|
|
|
.. sidebar:: Update the OS first!
|
|
|
|
To avoid unwanted side effects, update your OS before installing SearXNG.
|
|
|
|
The following will install a setup as shown in :ref:`the reference architecture
|
|
<arch public>`. First you need to get a clone of the repository. The clone is only needed for
|
|
the installation procedure and some maintenance tasks.
|
|
|
|
.. sidebar:: further read
|
|
|
|
- :ref:`toolboxing`
|
|
|
|
Jump to a folder that is readable by *others* and start to clone SearXNG,
|
|
alternatively you can create your own fork and clone from there.
|
|
|
|
.. code:: bash
|
|
|
|
$ cd ~/Downloads
|
|
$ git clone https://github.com/searxng/searxng.git searxng
|
|
$ cd searxng
|
|
|
|
.. sidebar:: further read
|
|
|
|
- :ref:`inspect searxng`
|
|
|
|
To install a SearXNG :ref:`reference setup <use_default_settings.yml>`
|
|
including a :ref:`uWSGI setup <architecture uWSGI>` as described in the
|
|
:ref:`installation basic` and in the :ref:`searxng uwsgi` section type:
|
|
|
|
.. code:: bash
|
|
|
|
$ sudo -H ./utils/searxng.sh install all
|
|
|
|
.. attention::
|
|
|
|
For the installation procedure, use a *sudoer* login to run the scripts. If
|
|
you install from ``root``, take into account that the scripts are creating a
|
|
``searxng`` user. In the installation procedure this new created user does
|
|
need to have read access to the cloned SearXNG repository, which is not the case if you clone
|
|
it into a folder below ``/root``!
|
|
|
|
.. sidebar:: further read
|
|
|
|
- :ref:`update searxng`
|
|
|
|
.. _caddy: https://hub.docker.com/_/caddy
|
|
|
|
When all services are installed and running fine, you can add SearXNG to your
|
|
HTTP server. We do not have any preferences regarding the HTTP server, you can use
|
|
whatever you prefer.
|
|
|
|
We implemented installation procedures for:
|
|
|
|
- :ref:`installation nginx`
|
|
- :ref:`installation apache`
|