[doc] build from commit 6dab7fe78be3c8872b8a6d99cf00c597813171bagh-pages

1 files changed, 31 insertions, 0 deletions

diff --git a/_sources/utils/index.rst.txt b/_sources/utils/index.rst.txt
new file mode 100644
index 000000000..b570b07e6
--- /dev/null
+++ b/_sources/utils/index.rst.txt
@@ -0,0 +1,31 @@
+.. _searx_utils:
+.. _toolboxing:
+
+==================
+DevOps tooling box
+==================
+
+In the folder :origin:`utils/` we maintain some tools useful for administrators
+and developers.
+
+.. toctree::
+   :maxdepth: 2
+
+   searxng.sh
+   lxc.sh
+
+Common command environments
+===========================
+
+The scripts in our tooling box often dispose of common environments:
+
+.. _FORCE_TIMEOUT:
+
+``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
+  SearXNG server and nginx proxy on all containers of the :ref:`SearXNG suite
+  <lxc-searxng.env>` use::
+
+    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