forked from Ponysearch/Ponysearch
2964a24b3d
modified docs/admin/engines/settings.rst
- Fix documentation and add section 'brand'.
- Add remarks about **buildenv** variables.
- Add remarks about settings from environment variables $SEARX_DEBUG,
$SEARX_PORT, $SEARX_BIND_ADDRESS and $SEARX_SECRET
modified docs/admin/installation-searx.rst & docs/build-templates/searx.rst
Fix template location /templates/etc/searx/settings.yml
modified docs/dev/makefile.rst
Add description of the 'make buildenv' target and describe
- we have all SearXNG setups are centralized in the settings.yml file
- why some tasks need a utils/brand.env (aka instance's buildenv)
modified manage
Settings file from repository's working tree are used by default and
ask user if a /etc/searx/settings.yml file exists.
modified searx/settings.yml
Add comments about when it is needed to run 'make buildenv'
modified searx/settings_defaults.py
Default for server:port is taken from enviroment variable SEARX_PORT.
modified utils/build_env.py
- Some defaults in the settings.yml are taken from the environment,
e.g. SEARX_BIND_ADDRESS (searx.settings_defaults.SHEMA). When the
'brand.env' file is created these enviroment variables should be
unset first.
- The CONTACT_URL enviroment is not needed in the utils/brand.env
Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
120 lines
3.3 KiB
ReStructuredText
120 lines
3.3 KiB
ReStructuredText
.. _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.
|
||
|
||
.. _install packages:
|
||
|
||
Install packages
|
||
================
|
||
|
||
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
||
:start-after: START distro-packages
|
||
:end-before: END distro-packages
|
||
|
||
.. hint::
|
||
|
||
This installs also the packages needed by :ref:`searx uwsgi`
|
||
|
||
.. _create searx user:
|
||
|
||
Create user
|
||
===========
|
||
|
||
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
||
:start-after: START create user
|
||
:end-before: END create user
|
||
|
||
.. _searx-src:
|
||
|
||
install searx & dependencies
|
||
============================
|
||
|
||
Start a interactive shell from new created user and clone searx:
|
||
|
||
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
||
:start-after: START clone searx
|
||
:end-before: END clone searx
|
||
|
||
In the same shell create *virtualenv*:
|
||
|
||
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
||
:start-after: START create virtualenv
|
||
:end-before: END create virtualenv
|
||
|
||
To install searx's dependencies, exit the searx *bash* session you opened above
|
||
and restart a new. Before install, first check if your *virtualenv* was sourced
|
||
from the login (*~/.profile*):
|
||
|
||
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
||
:start-after: START manage.sh update_packages
|
||
:end-before: END manage.sh update_packages
|
||
|
||
.. tip::
|
||
|
||
Open a second terminal for the configuration tasks and leave the ``(searx)$``
|
||
terminal open for the tasks below.
|
||
|
||
|
||
.. _use_default_settings.yml:
|
||
|
||
Configuration
|
||
=============
|
||
|
||
.. sidebar:: ``use_default_settings: True``
|
||
|
||
- :ref:`settings global`
|
||
- :ref:`settings location`
|
||
- :ref:`settings use_default_settings`
|
||
- :origin:`/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 :origin:`utils/templates/etc/searx/use_default_settings.yml`. This setup
|
||
:ref:`use default settings <settings use_default_settings>` from
|
||
:origin:`searx/settings.yml` and is recommended since :pull-searx:`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.
|
||
|
||
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
||
:start-after: START searx config
|
||
:end-before: END searx config
|
||
|
||
.. tabs::
|
||
|
||
.. group-tab:: Use default settings
|
||
|
||
.. literalinclude:: ../../utils/templates/etc/searx/settings.yml
|
||
:language: yaml
|
||
|
||
.. group-tab:: searx/settings.yml
|
||
|
||
.. literalinclude:: ../../searx/settings.yml
|
||
:language: yaml
|
||
|
||
|
||
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.
|
||
|
||
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
|
||
: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
|
||
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.
|
||
|