3.3 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 SearXNG & 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 SearXNG bash session you opened above and restart a new. Before install, first check if your virtualenv was sourced from the login (~/.profile):
$DOCS_BUILD/includes/searx.rst
Tip
Open a second terminal for the configuration tasks and leave the (searx)$ terminal open for the tasks below.
Configuration
use_default_settings: True
settings globalsettings locationsettings use_default_settings/etc/searx/settings.yml <utils/templates/etc/searx/use_default_settings.yml>
To create a initial /etc/searx/settings.yml you can start with a copy of the file utils/templates/etc/searx/use_default_settings.yml. This setup use default settings <settings use_default_settings> from searx/settings.yml and is recommended since 2291 is merged.
For a minimal setup, configure like shown below – replace searx@$(uname -n) with a name of your choice, set ultrasecretkey -- and/or edit /etc/searx/settings.yml to your needs.
$DOCS_BUILD/includes/searx.rst
Use default settings
../../utils/templates/etc/searx/settings.yml
searx/settings.yml
../../searx/settings.yml
Check
To check your SearXNG setup, optional enable debugging and start the webapp. SearXNG looks at the exported environment $SEARXNG_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 SearXNG user bash (enter exit command twice). At this point SearXNG is not demonized; uwsgi allows this.