summaryrefslogtreecommitdiff
path: root/docs/utils/index.rst
diff options
context:
space:
mode:
authorMarkus Heiser <markus.heiser@darmarIT.de>2022-07-30 13:45:12 +0200
committerGitHub <noreply@github.com>2022-07-30 13:45:12 +0200
commit645c2a2ca1cf40ab9429366ac70c69d1ac8fd004 (patch)
tree943270e4998815d360713e21615082293300c877 /docs/utils/index.rst
parent0cf5310933ee4f6bff4a941f7296686bd671671f (diff)
parente5323b8aa285d61bf011bbe7ca8f02818f19ed79 (diff)
Merge pull request #1332 from return42/searxng-install
Upgrade installation scripts and documentation
Diffstat (limited to 'docs/utils/index.rst')
-rw-r--r--docs/utils/index.rst48
1 files changed, 13 insertions, 35 deletions
diff --git a/docs/utils/index.rst b/docs/utils/index.rst
index 2077bbb13..2da26ed12 100644
--- a/docs/utils/index.rst
+++ b/docs/utils/index.rst
@@ -1,52 +1,30 @@
.. _searx_utils:
.. _toolboxing:
-===================
-Admin's tooling box
-===================
+==================
+DevOps tooling box
+==================
-In the folder :origin:`utils/` we maintain some tools useful for administrators.
+In the folder :origin:`utils/` we maintain some tools useful for administrators
+and developers.
.. toctree::
:maxdepth: 2
:caption: Contents
- searx.sh
- filtron.sh
- morty.sh
+ searxng.sh
lxc.sh
-.. _toolboxing common:
+Common command environments
+===========================
-Common commands & environment
-=============================
-
-Scripts to maintain services often dispose of common commands and environments.
-
-``shell`` : command
- Opens a shell from the service user ``${SERVICE_USSR}``, very helpful for
- troubleshooting.
-
-``inspect service`` : command
- Shows status and log of the service, most often you have a option to enable
- more verbose debug logs. Very helpful for debugging, but be careful not to
- enable debugging in a production environment!
+The scripts in our tooling box often dispose of common environments:
``FORCE_TIMEOUT`` : environment
Sets timeout for interactive prompts. If you want to run a script in batch
job, with defaults choices, set ``FORCE_TIMEOUT=0``. By example; to install a
- reverse proxy for filtron on all containers of the :ref:`SearXNG suite
- <lxc-searx.env>` use ::
-
- sudo -H ./utils/lxc.sh cmd -- FORCE_TIMEOUT=0 ./utils/filtron.sh apache install
-
-.. _toolboxing setup:
-
-Tooling box setup
-=================
-
-The main setup is done in the :origin:`.config.sh` (read also :ref:`settings
-global`).
+ SearXNG server and nginx proxy on all containers of the :ref:`SearXNG suite
+ <lxc-searxng.env>` use::
-.. literalinclude:: ../../.config.sh
- :language: bash
+ sudo -H ./utils/lxc.sh cmd -- FORCE_TIMEOUT=0 ./utils/searxng.sh install all
+ sudo -H ./utils/lxc.sh cmd -- FORCE_TIMEOUT=0 ./utils/searxng.sh install nginx