searxng/docs/admin/installation-switch2ng.rst
Markus Heiser 4577444ec4 [docs] Switch from searx to SearXNG
Closes: https://github.com/searxng/searxng/issues/450
Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
2022-01-17 10:05:13 +01:00

2.6 KiB

Switch from searx to SearXNG

Contents

If you have a searx installation on your sever and want to switch to SearXNG, you need to uninstall searx first. If you have an old searx docker installation replace your docker image / see installation docker.

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.

If you have removed the old searx installation, clone from SearXNG and and start with your installation procedure (e.g. installation scripts):

$ cd ~/Downloads
$ git clone https://github.com/searxng/searxng.git searxng
$ cd searxng
$ ...

.config.sh

Please take into account; SearXNG has normalized .config.sh with settings.yml and some of the environment settings has been removed from or renamed in the .config.sh:

  • [mod] normalize .config.sh with settings.yml <f61c918d>
  • [fix] ./utils/filtron.sh - FILTRON_TARGET from YAML settings <7196a9b5>
  • SearXNG: SEARXNG_SETTINGS_PATH <253b8503>

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/searx.sh install check

============================
SearXNG (check installation)
============================
ERROR: settings.yml in /etc/searx/ is deprecated, move file to folder /etc/searxng/
INFO:  SearXNG instance already installed at: /usr/local/searx/searx-src
...
INFO:  Service account searx exists.
INFO:  ~searx: python environment is available.
INFO:  ~searx: SearXNG software is installed.
INFO:  uWSGI app searxng.ini is enabled.
INFO    searx                         : merge the default settings ( /usr/local/searx/searx-src/searx/settings.yml ) and the user setttings ( /etc/searxng/settings.yml )
INFO    searx                         : max_request_timeout=None

To check the filtron & morty installations, use similar commands:

$ sudo -H /utils/filtron.sh install check
$ sudo -H /utils/morty.sh   install check