searxng/docs/admin/update-searxng.rst
Markus Heiser 5720844fcd [doc] rearranges Settings & Engines docs for better readability
We have built up detailed documentation of the *settings* and the *engines* over
the past few years.  However, this documentation was still spread over various
chapters and was difficult to navigate in its entirety.

This patch rearranges the Settings & Engines documentation for better
readability.

To review new ordered docs::

   make docs.clean docs.live

Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
2023-07-01 22:45:19 +02:00

4.1 KiB

SearXNG maintenance

further read

  • toolboxing
  • uWSGI maintenance

How to update

How to update depends on the installation method. If you have used the installation scripts, use the update command from the searxng.sh script.

sudo -H ./utils/searxng.sh instance update

How to inspect & debug

How to debug depends on the installation method. If you have used the installation scripts, use the inspect command from the searxng.sh script.

sudo -H ./utils/searxng.sh instance inspect

Migrate and stay tuned!

info

  • 1332
  • 456
  • A comment about rolling release <446#issuecomment-954730358>

SearXNG is a rolling release; each commit to the master branch is a release. SearXNG is growing rapidly, the services and opportunities are change every now and then, to name just a few:

  • Bot protection has been switched from filtron to SearXNG's limiter <limiter>, this requires a Redis <settings redis> database.
  • The image proxy morty is no longer needed, it has been replaced by the image proxy <image_proxy> from SearXNG.
  • To save bandwith cache busting <static_use_hash> has been implemented. To get in use, the static-expires needs to be set in the uwsgi setup.

To stay tuned and get in use of the new features, instance maintainers have to update the SearXNG code regularly (see update searxng). As the above examples show, this is not always enough, sometimes services have to be set up or reconfigured and sometimes services that are no longer needed should be uninstalled.

Hint

First of all: SearXNG is installed by the script searxng.sh. If you have old filtron, morty or searx setup you should consider complete uninstall/reinstall.

Here you will find a list of changes that affect the infrastructure. Please check to what extent it is necessary to update your installations:

1595: [fix] uWSGI: increase buffer-size

Re-install uWSGI (searxng.sh) or fix your uWSGI searxng.ini file manually.

remove obsolete services

If your searx instance was installed "Step by step" or by the "Installation scripts", you need to undo the installation procedure completely. If you have morty & filtron installed, it is recommended to uninstall these services also. In case of scripts, to uninstall use the scripts from the origin you installed searx from or try:

$ sudo -H ./utils/filtron.sh remove all
$ sudo -H ./utils/morty.sh   remove all
$ sudo -H ./utils/searx.sh   remove all

Hint

If you are migrate from searx take into account that the .config.sh is no longer used.

If you upgrade from searx or from before 1332 has been merged and you have filtron and/or morty installed, don't forget to remove HTTP sites.

Apache:

$ sudo -H ./utils/filtron.sh apache remove
$ sudo -H ./utils/morty.sh apache remove

nginx:

$ sudo -H ./utils/filtron.sh nginx remove
$ sudo -H ./utils/morty.sh nginx remove

Check after Installation

Once you have done your installation, you can run a SearXNG check procedure, to see if there are some left overs. In this example there exists a old /etc/searx/settings.yml:

$ sudo -H ./utils/searxng.sh instance check

SearXNG checks
--------------
ERROR: settings.yml in /etc/searx/ is deprecated, move file to folder /etc/searxng/
INFO:  [OK] (old) account 'searx' does not exists
INFO:  [OK] (old) account 'filtron' does not exists
INFO:  [OK] (old) account 'morty' does not exists
...
INFO    searx.redisdb                 : connecting to Redis db=0 path='/usr/local/searxng-redis/run/redis.sock'
INFO    searx.redisdb                 : connected to Redis