.. _installation switch2ng:

============================
Switch from searx to SearXNG
============================

.. sidebar:: info

   - :pull:`456`
   - `A comment about rolling release <https://github.com/searxng/searxng/pull/446#issuecomment-954730358>`_

.. contents:: Contents
   :depth: 2
   :local:
   :backlinks: entry

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 :ref:`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. :ref:`installation scripts`):

.. code:: bash

   $ 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``:

- :patch:`[mod] normalize .config.sh with settings.yml <f61c918d>`
- :patch:`[fix] ./utils/filtron.sh - FILTRON_TARGET from YAML settings <7196a9b5>`
- :patch:`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
