diff options
| author | Markus Heiser <markus.heiser@darmarit.de> | 2022-06-14 10:02:50 +0200 |
|---|---|---|
| committer | Markus Heiser <markus.heiser@darmarit.de> | 2022-07-30 13:39:35 +0200 |
| commit | ed8a1690296cfc55f67dc0a4dac6dee06a47bd06 (patch) | |
| tree | c2d2a4c8e5369b4f9a65d12c23c2dd0cb05d58f0 /docs/build-templates/searx.rst | |
| parent | 782f73540e2d383ea122716507ccd9582918ab51 (diff) | |
[doc] update documentation of the installation procedures
Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
Diffstat (limited to 'docs/build-templates/searx.rst')
| -rw-r--r-- | docs/build-templates/searx.rst | 209 |
1 files changed, 0 insertions, 209 deletions
diff --git a/docs/build-templates/searx.rst b/docs/build-templates/searx.rst deleted file mode 100644 index 0e7877ba4..000000000 --- a/docs/build-templates/searx.rst +++ /dev/null @@ -1,209 +0,0 @@ -.. template evaluated by: ./utils/searx.sh doc -.. hint: all dollar-names are variables, dollar sign itself is quoted by: \\$ - -.. START distro-packages - -.. tabs:: - - .. group-tab:: Ubuntu / debian - - .. code-block:: sh - - $ sudo -H apt-get install -y \\ -${debian} - - .. group-tab:: Arch Linux - - .. code-block:: sh - - $ sudo -H pacman -S --noconfirm \\ -${arch} - - .. group-tab:: Fedora / RHEL - - .. code-block:: sh - - $ sudo -H dnf install -y \\ -${fedora} - -.. END distro-packages - -.. START build-packages - -.. tabs:: - - .. group-tab:: Ubuntu / debian - - .. code-block:: sh - - $ sudo -H apt-get install -y \\ -${debian_build} - - .. group-tab:: Arch Linux - - .. code-block:: sh - - $ sudo -H pacman -S --noconfirm \\ -${arch_build} - - .. group-tab:: Fedora / RHEL - - .. code-block:: sh - - $ sudo -H dnf install -y \\ -${fedora_build} - -.. END build-packages - -.. START create user - -.. tabs:: - - .. group-tab:: bash - - .. code-block:: sh - - $ sudo -H useradd --shell /bin/bash --system \\ - --home-dir \"$SERVICE_HOME\" \\ - --comment 'Privacy-respecting metasearch engine' $SERVICE_USER - - $ sudo -H mkdir \"$SERVICE_HOME\" - $ sudo -H chown -R \"$SERVICE_GROUP:$SERVICE_GROUP\" \"$SERVICE_HOME\" - -.. END create user - -.. START clone searxng - -.. tabs:: - - .. group-tab:: bash - - .. code-block:: sh - - $ sudo -H -u ${SERVICE_USER} -i - (${SERVICE_USER})$ git clone \"$GIT_URL\" \"$SEARXNG_SRC\" - -.. END clone searxng - -.. START create virtualenv - -.. tabs:: - - .. group-tab:: bash - - .. code-block:: sh - - (${SERVICE_USER})$ python3 -m venv \"${SEARXNG_PYENV}\" - (${SERVICE_USER})$ echo \". ${SEARXNG_PYENV}/bin/activate\" >> \"$SERVICE_HOME/.profile\" - -.. END create virtualenv - -.. START manage.sh update_packages - -.. tabs:: - - .. group-tab:: bash - - .. code-block:: sh - - $ sudo -H -u ${SERVICE_USER} -i - - (${SERVICE_USER})$ command -v python && python --version - $SEARXNG_PYENV/bin/python - Python 3.8.1 - - # update pip's boilerplate .. - pip install -U pip - pip install -U setuptools - pip install -U wheel - pip install -U pyyaml - - # jump to SearXNG's working tree and install SearXNG into virtualenv - (${SERVICE_USER})$ cd \"$SEARXNG_SRC\" - (${SERVICE_USER})$ pip install -e . - - -.. END manage.sh update_packages - -.. START searxng config - -.. tabs:: - - .. group-tab:: Use default settings - - .. code-block:: sh - - $ sudo -H mkdir -p \"$(dirname ${SEARXNG_SETTINGS_PATH})\" - $ sudo -H cp \"$SEARXNG_SRC/utils/templates/etc/searxng/settings.yml\" \\ - \"${SEARXNG_SETTINGS_PATH}\" - - .. group-tab:: searx/settings.yml - - .. code-block:: sh - - $ sudo -H mkdir -p \"$(dirname ${SEARXNG_SETTINGS_PATH})\" - $ sudo -H cp \"$SEARXNG_SRC/searx/settings.yml\" \\ - \"${SEARXNG_SETTINGS_PATH}\" - -.. tabs:: - - .. group-tab:: minimal setup - - .. code-block:: sh - - $ sudo -H sed -i -e \"s/ultrasecretkey/\$(openssl rand -hex 16)/g\" \"$SEARXNG_SETTINGS_PATH\" - -.. END searxng config - -.. START check searxng installation - -.. tabs:: - - .. group-tab:: bash - - .. code-block:: sh - - # enable debug .. - $ sudo -H sed -i -e \"s/debug : False/debug : True/g\" \"$SEARXNG_SETTINGS_PATH\" - - # start webapp - $ sudo -H -u ${SERVICE_USER} -i - (${SERVICE_USER})$ cd ${SEARXNG_SRC} - (${SERVICE_USER})$ export SEARXNG_SETTINGS_PATH=\"${SEARXNG_SETTINGS_PATH}\" - (${SERVICE_USER})$ python searx/webapp.py - - # disable debug - $ sudo -H sed -i -e \"s/debug : True/debug : False/g\" \"$SEARXNG_SETTINGS_PATH\" - -Open WEB browser and visit http://$SEARXNG_INTERNAL_HTTP . If you are inside a -container or in a script, test with curl: - -.. tabs:: - - .. group-tab:: WEB browser - - .. code-block:: sh - - $ xdg-open http://$SEARXNG_INTERNAL_HTTP - - .. group-tab:: curl - - .. code-block:: none - - $ curl --location --verbose --head --insecure $SEARXNG_INTERNAL_HTTP - - * Trying 127.0.0.1:8888... - * TCP_NODELAY set - * Connected to 127.0.0.1 (127.0.0.1) port 8888 (#0) - > HEAD / HTTP/1.1 - > Host: 127.0.0.1:8888 - > User-Agent: curl/7.68.0 - > Accept: */* - > - * Mark bundle as not supporting multiuse - * HTTP 1.0, assume close after body - < HTTP/1.0 200 OK - HTTP/1.0 200 OK - ... - -.. END check searxng installation |