mirror of
https://github.com/searxng/searxng.git
synced 2025-07-09 03:04:26 -04:00
f798ddd492
This patch migrates from `redis==5.2.1` [1] to `valkey==6.1.0` [2].
The migration to valkey is necessary because the company behind Redis has decided
to abandon the open source license. After experiencing a drop in user numbers,
they now want to run it under a dual license again. But this move demonstrates
once again how unreliable the company is and how it treats open source
developers.
To review first, read the docs::
$ make docs.live
Follow the instructions to remove redis:
- http://0.0.0.0:8000/admin/settings/settings_redis.html
Config and install a local valkey DB:
- http://0.0.0.0:8000/admin/settings/settings_valkey.html
[1] https://pypi.org/project/redis/
[2] https://pypi.org/project/valkey/
Co-authored-by: HLFH <gaspard@dhautefeuille.eu>
Co-authored-by: Markus Heiser <markus.heiser@darmarit.de>
94 lines
2.7 KiB
ReStructuredText
94 lines
2.7 KiB
ReStructuredText
.. _searxng maintenance:
|
|
|
|
===================
|
|
SearXNG maintenance
|
|
===================
|
|
|
|
.. sidebar:: further read
|
|
|
|
- :ref:`toolboxing`
|
|
- :ref:`uWSGI maintenance`
|
|
|
|
.. contents::
|
|
:depth: 2
|
|
:local:
|
|
:backlinks: entry
|
|
|
|
.. _update searxng:
|
|
|
|
How to update
|
|
=============
|
|
|
|
How to update depends on the :ref:`installation` method. If you have used the
|
|
:ref:`installation scripts`, use the ``update`` command from the :ref:`searxng.sh`
|
|
script.
|
|
|
|
.. code:: sh
|
|
|
|
sudo -H ./utils/searxng.sh instance update
|
|
|
|
.. _inspect searxng:
|
|
|
|
How to inspect & debug
|
|
======================
|
|
|
|
How to debug depends on the :ref:`installation` method. If you have used the
|
|
:ref:`installation scripts`, use the ``inspect`` command from the :ref:`searxng.sh`
|
|
script.
|
|
|
|
.. code:: sh
|
|
|
|
sudo -H ./utils/searxng.sh instance inspect
|
|
|
|
.. _migrate and stay tuned:
|
|
|
|
Migrate and stay tuned!
|
|
=======================
|
|
|
|
.. sidebar:: info
|
|
|
|
- :pull:`1332`
|
|
- :pull:`456`
|
|
- :pull:`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 :ref:`limiter
|
|
<limiter>`, this requires a :ref:`Valkey <settings valkey>` database.
|
|
|
|
- To save bandwidth :ref:`cache busting <static_use_hash>` has been implemented.
|
|
To get in use, the ``static-expires`` needs to be set in the :ref:`uwsgi
|
|
setup`.
|
|
|
|
To stay tuned and get in use of the new features, instance maintainers have to
|
|
update the SearXNG code regularly (see :ref:`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.
|
|
|
|
Here you will find a list of changes that affect the infrastructure. Please
|
|
check to what extent it is necessary to update your installations:
|
|
|
|
:pull:`1595`: ``[fix] uWSGI: increase buffer-size``
|
|
Re-install uWSGI (:ref:`searxng.sh`) or fix your uWSGI ``searxng.ini``
|
|
file manually.
|
|
|
|
|
|
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 searx.valkeydb : connecting to Valkey db=0 path='/usr/local/searxng-valkey/run/valkey.sock'
|
|
INFO searx.valkeydb : connected to Valkey
|