searxng/docs/admin/installation-searx.rst
Markus Heiser bfef2c3b65 [fix] buildprocess of docs in LXC (containers)
The $DOCS_BUILD variable (like all BUILD variables) in the lxc environment::

   sudo -H ./utils/lxc.sh cmd searx-archlinux make docs

is different from running build process in the HOST::

   make docs

with kernel-include directive we can use the environment variables in the reST
documents to address the correct file location of the include.

Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
2020-06-18 18:52:45 +02:00

2.5 KiB

Step by step installation

Contents

Step by step installation with virtualenv. For Ubuntu, be sure to have enable universe repository.

Install packages

$DOCS_BUILD/includes/searx.rst

Hint

This installs also the packages needed by searx uwsgi

Create user

$DOCS_BUILD/includes/searx.rst

install searx & dependencies

Start a interactive shell from new created user and clone searx:

$DOCS_BUILD/includes/searx.rst

In the same shell create virtualenv:

$DOCS_BUILD/includes/searx.rst

To install searx's dependencies, exit the searx bash session you opened above and restart a new. Before install, first check if your virualenv was sourced from the login (~/.profile):

$DOCS_BUILD/includes/searx.rst

Tip

Open a second terminal for the configuration tasks and left the (searx)$ terminal open for the tasks below.

Configuration

Create a copy of the searx/settings.yml configuration file in system's /etc folder. Configure like shown below -- replace searx@\$(uname -n) with a name of your choice -- and/or edit /etc/searx/settings.yml if necessary.

$DOCS_BUILD/includes/searx.rst

Check

To check your searx setup, optional enable debugging and start the webapp. Searx looks at the exported environment $SEARX_SETTINGS_PATH for a configuration file.

$DOCS_BUILD/includes/searx.rst

If everything works fine, hit [CTRL-C] to stop the webapp and disable the debug option in settings.yml. You can now exit searx user bash (enter exit command twice). At this point searx is not demonized; uwsgi allows this.