index.rst 1.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. .. _searx_utils:
  2. .. _toolboxing:
  3. =======================
  4. Tooling box ``utils/*``
  5. =======================
  6. In the folder :origin:`utils/` we maintain some tools useful for admins and
  7. developers.
  8. .. toctree::
  9. :maxdepth: 2
  10. :caption: Contents
  11. searx.sh
  12. filtron.sh
  13. morty.sh
  14. lxc.sh
  15. standalone_searx.py
  16. .. _toolboxing common:
  17. Common commands & environment
  18. =============================
  19. Scripts to maintain services often dispose of common commands and environments.
  20. ``shell`` : command
  21. Opens a shell from the service user ``${SERVICE_USSR}``, very helpful for
  22. troubleshooting.
  23. ``inspect service`` : command
  24. Shows status and log of the service, most often you have a option to enable
  25. more verbose debug logs. Very helpful for debugging, but be careful not to
  26. enable debugging in a production environment!
  27. ``FORCE_TIMEOUT`` : environment
  28. Sets timeout for interactive prompts. If you want to run a script in batch
  29. job, with defaults choices, set ``FORCE_TIMEOUT=0``. By example; to install a
  30. reverse proxy for filtron on all containers of the :ref:`searx suite
  31. <lxc-searx.env>` use ::
  32. sudo -H ./utils/lxc.sh cmd -- FORCE_TIMEOUT=0 ./utils/filtron.sh apache install
  33. .. _toolboxing setup:
  34. Tooling box setup
  35. =================
  36. The main setup is done in the :origin:`.config.sh` (read also :ref:`makefile
  37. setup`).
  38. .. literalinclude:: ../../.config.sh
  39. :language: bash