2020-03-02 19:00:19 +01:00
|
|
|
|
.. _installation basic:
|
|
|
|
|
|
|
|
|
|
=========================
|
|
|
|
|
Step by step installation
|
|
|
|
|
=========================
|
|
|
|
|
|
|
|
|
|
.. contents:: Contents
|
|
|
|
|
:depth: 2
|
|
|
|
|
:local:
|
|
|
|
|
:backlinks: entry
|
|
|
|
|
|
|
|
|
|
Step by step installation with virtualenv. For Ubuntu, be sure to have enable
|
|
|
|
|
universe repository.
|
|
|
|
|
|
2020-03-04 12:22:20 +01:00
|
|
|
|
.. _install packages:
|
|
|
|
|
|
2020-03-02 19:00:19 +01:00
|
|
|
|
Install packages
|
|
|
|
|
================
|
|
|
|
|
|
2020-06-18 18:52:45 +02:00
|
|
|
|
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
2020-03-02 19:00:19 +01:00
|
|
|
|
:start-after: START distro-packages
|
|
|
|
|
:end-before: END distro-packages
|
|
|
|
|
|
|
|
|
|
.. hint::
|
|
|
|
|
|
|
|
|
|
This installs also the packages needed by :ref:`searx uwsgi`
|
|
|
|
|
|
2020-04-07 18:31:51 +02:00
|
|
|
|
.. _create searx user:
|
|
|
|
|
|
2020-03-02 19:00:19 +01:00
|
|
|
|
Create user
|
|
|
|
|
===========
|
|
|
|
|
|
2020-06-18 18:52:45 +02:00
|
|
|
|
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
2020-03-02 19:00:19 +01:00
|
|
|
|
:start-after: START create user
|
|
|
|
|
:end-before: END create user
|
|
|
|
|
|
2020-03-06 14:47:00 +01:00
|
|
|
|
.. _searx-src:
|
|
|
|
|
|
2021-09-12 08:36:56 +02:00
|
|
|
|
Install SearXNG & dependencies
|
|
|
|
|
==============================
|
2020-03-03 19:57:15 +01:00
|
|
|
|
|
2020-03-02 19:00:19 +01:00
|
|
|
|
Start a interactive shell from new created user and clone searx:
|
|
|
|
|
|
2020-06-18 18:52:45 +02:00
|
|
|
|
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
2020-03-02 19:00:19 +01:00
|
|
|
|
:start-after: START clone searx
|
|
|
|
|
:end-before: END clone searx
|
|
|
|
|
|
|
|
|
|
In the same shell create *virtualenv*:
|
|
|
|
|
|
2020-06-18 18:52:45 +02:00
|
|
|
|
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
2020-03-02 19:00:19 +01:00
|
|
|
|
:start-after: START create virtualenv
|
|
|
|
|
:end-before: END create virtualenv
|
|
|
|
|
|
2021-09-12 08:36:56 +02:00
|
|
|
|
To install searx's dependencies, exit the SearXNG *bash* session you opened above
|
2020-11-06 16:45:39 +01:00
|
|
|
|
and restart a new. Before install, first check if your *virtualenv* was sourced
|
2020-03-02 19:00:19 +01:00
|
|
|
|
from the login (*~/.profile*):
|
|
|
|
|
|
2020-06-18 18:52:45 +02:00
|
|
|
|
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
2020-03-02 19:00:19 +01:00
|
|
|
|
:start-after: START manage.sh update_packages
|
|
|
|
|
:end-before: END manage.sh update_packages
|
|
|
|
|
|
|
|
|
|
.. tip::
|
|
|
|
|
|
2021-04-09 15:56:59 +02:00
|
|
|
|
Open a second terminal for the configuration tasks and leave the ``(searx)$``
|
2020-03-02 19:00:19 +01:00
|
|
|
|
terminal open for the tasks below.
|
|
|
|
|
|
2020-12-08 20:19:10 +01:00
|
|
|
|
|
|
|
|
|
.. _use_default_settings.yml:
|
|
|
|
|
|
2020-03-02 19:00:19 +01:00
|
|
|
|
Configuration
|
2020-12-08 20:19:10 +01:00
|
|
|
|
=============
|
|
|
|
|
|
2021-01-02 19:56:26 +01:00
|
|
|
|
.. sidebar:: ``use_default_settings: True``
|
|
|
|
|
|
|
|
|
|
- :ref:`settings global`
|
|
|
|
|
- :ref:`settings location`
|
|
|
|
|
- :ref:`settings use_default_settings`
|
2021-10-08 11:35:47 +02:00
|
|
|
|
- :origin:`/etc/searxng/settings.yml <utils/templates/etc/searx/use_default_settings.yml>`
|
2021-01-02 19:56:26 +01:00
|
|
|
|
|
2021-10-08 11:35:47 +02:00
|
|
|
|
To create a initial ``/etc/searxng/settings.yml`` you can start with a copy of the
|
2020-12-08 20:19:10 +01:00
|
|
|
|
file :origin:`utils/templates/etc/searx/use_default_settings.yml`. This setup
|
2021-01-02 19:56:26 +01:00
|
|
|
|
:ref:`use default settings <settings use_default_settings>` from
|
2021-04-25 12:03:54 +02:00
|
|
|
|
:origin:`searx/settings.yml` and is recommended since :pull-searx:`2291` is merged.
|
2020-03-02 19:00:19 +01:00
|
|
|
|
|
2021-01-02 19:56:26 +01:00
|
|
|
|
For a *minimal setup*, configure like shown below – replace ``searx@$(uname
|
|
|
|
|
-n)`` with a name of your choice, set ``ultrasecretkey`` -- *and/or* edit
|
2021-10-08 11:35:47 +02:00
|
|
|
|
``/etc/searxng/settings.yml`` to your needs.
|
2020-03-02 19:00:19 +01:00
|
|
|
|
|
2020-06-18 18:52:45 +02:00
|
|
|
|
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
2020-03-02 19:00:19 +01:00
|
|
|
|
:start-after: START searx config
|
|
|
|
|
:end-before: END searx config
|
|
|
|
|
|
2020-12-08 20:19:10 +01:00
|
|
|
|
.. tabs::
|
|
|
|
|
|
|
|
|
|
.. group-tab:: Use default settings
|
|
|
|
|
|
2021-06-29 19:46:06 +02:00
|
|
|
|
.. literalinclude:: ../../utils/templates/etc/searx/settings.yml
|
2020-12-08 20:19:10 +01:00
|
|
|
|
:language: yaml
|
|
|
|
|
|
|
|
|
|
.. group-tab:: searx/settings.yml
|
|
|
|
|
|
|
|
|
|
.. literalinclude:: ../../searx/settings.yml
|
|
|
|
|
:language: yaml
|
|
|
|
|
|
|
|
|
|
|
2020-03-02 19:00:19 +01:00
|
|
|
|
Check
|
|
|
|
|
=====
|
|
|
|
|
|
2021-09-12 08:36:56 +02:00
|
|
|
|
To check your SearXNG setup, optional enable debugging and start the *webapp*.
|
2021-10-02 17:18:05 +02:00
|
|
|
|
SearXNG looks at the exported environment ``$SEARXNG_SETTINGS_PATH`` for a
|
2020-03-02 19:00:19 +01:00
|
|
|
|
configuration file.
|
|
|
|
|
|
2020-06-18 18:52:45 +02:00
|
|
|
|
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
2020-03-02 19:00:19 +01:00
|
|
|
|
:start-after: START check searx installation
|
|
|
|
|
:end-before: END check searx installation
|
|
|
|
|
|
|
|
|
|
If everything works fine, hit ``[CTRL-C]`` to stop the *webapp* and disable the
|
2021-09-12 08:36:56 +02:00
|
|
|
|
debug option in ``settings.yml``. You can now exit SearXNG user bash (enter exit
|
|
|
|
|
command twice). At this point SearXNG is not demonized; uwsgi allows this.
|
2020-03-02 19:00:19 +01:00
|
|
|
|
|