SearXNG maintenance¶
How to update¶
How to update depends on the Installation method. If you have used the
Installation Script, use the update
command from the utils/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 Script, use the inspect
command from the utils/searxng.sh
script.
sudo -H ./utils/searxng.sh instance inspect
Migrate and stay tuned!¶
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, this requires a Redis database.
The image proxy morty is no longer needed, it has been replaced by the image proxy from SearXNG.
To save bandwidth cache busting 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 How to update). 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 utils/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:
- PR 1595:
[fix] uWSGI: increase buffer-size
Re-install uWSGI (utils/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 PR 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