installation-switch2ng.rst 2.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475
  1. .. _installation switch2ng:
  2. ============================
  3. Switch from searx to SearXNG
  4. ============================
  5. .. sidebar:: info
  6. - :pull:`456`
  7. - `A comment about rolling release <https://github.com/searxng/searxng/pull/446#issuecomment-954730358>`_
  8. .. contents:: Contents
  9. :depth: 2
  10. :local:
  11. :backlinks: entry
  12. If you have a searx installation on your sever and want to switch to SearXNG,
  13. you need to uninstall searx first. If you have an old searx docker installation
  14. replace your docker image / see :ref:`installation docker`.
  15. If your searx instance was installed *"Step by step"* or by the *"Installation
  16. scripts"*, you need to undo the installation procedure completely. If you have
  17. morty & filtron installed, it is recommended to uninstall these services also.
  18. In case of scripts, to uninstall use the scripts from the origin you installed
  19. searx from.
  20. If you have removed the old searx installation, clone from SearXNG and and start
  21. with your installation procedure (e.g. :ref:`installation scripts`):
  22. .. code:: bash
  23. $ cd ~/Downloads
  24. $ git clone https://github.com/searxng/searxng.git searxng
  25. $ cd searxng
  26. $ ...
  27. ``.config.sh``
  28. ==============
  29. Please take into account; SearXNG has normalized ``.config.sh`` with
  30. ``settings.yml`` and some of the environment settings has been removed from or
  31. renamed in the ``.config.sh``:
  32. - :patch:`[mod] normalize .config.sh with settings.yml <f61c918d>`
  33. - :patch:`[fix] ./utils/filtron.sh - FILTRON_TARGET from YAML settings <7196a9b5>`
  34. - :patch:`SearXNG: SEARXNG_SETTINGS_PATH <253b8503>`
  35. Check after Installation
  36. ========================
  37. Once you have done your installation, you can run a SearXNG *check* procedure,
  38. to see if there are some left overs. In this example there exists a *old*
  39. ``/etc/searx/settings.yml``::
  40. $ sudo -H ./utils/searx.sh install check
  41. ============================
  42. SearXNG (check installation)
  43. ============================
  44. ERROR: settings.yml in /etc/searx/ is deprecated, move file to folder /etc/searxng/
  45. INFO: SearXNG instance already installed at: /usr/local/searx/searx-src
  46. ...
  47. INFO: Service account searx exists.
  48. INFO: ~searx: python environment is available.
  49. INFO: ~searx: SearXNG software is installed.
  50. INFO: uWSGI app searxng.ini is enabled.
  51. INFO searx : merge the default settings ( /usr/local/searx/searx-src/searx/settings.yml ) and the user setttings ( /etc/searxng/settings.yml )
  52. INFO searx : max_request_timeout=None
  53. To *check* the filtron & morty installations, use similar commands::
  54. $ sudo -H /utils/filtron.sh install check
  55. $ sudo -H /utils/morty.sh install check