summaryrefslogtreecommitdiff
path: root/docs/utils/lxc.sh.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/lxc.sh.rst
parent0cf5310933ee4f6bff4a941f7296686bd671671f (diff)
parente5323b8aa285d61bf011bbe7ca8f02818f19ed79 (diff)
Merge pull request #1332 from return42/searxng-install
Upgrade installation scripts and documentation
Diffstat (limited to 'docs/utils/lxc.sh.rst')
-rw-r--r--docs/utils/lxc.sh.rst52
1 files changed, 25 insertions, 27 deletions
diff --git a/docs/utils/lxc.sh.rst b/docs/utils/lxc.sh.rst
index f09b033f4..4308a12cc 100644
--- a/docs/utils/lxc.sh.rst
+++ b/docs/utils/lxc.sh.rst
@@ -23,7 +23,7 @@
With the use of *Linux Containers* (LXC_) we can scale our tasks over a stack of
containers, what we call the: *lxc suite*. The *SearXNG suite*
-(:origin:`lxc-searx.env <utils/lxc-searx.env>`) is loaded by default, every time
+(:origin:`lxc-searxng.env <utils/lxc-searxng.env>`) is loaded by default, every time
you start the ``lxc.sh`` script (*you do not need to care about*).
Before you can start with containers, you need to install and initiate LXD_
@@ -49,7 +49,7 @@ help>`.
If you do not want to build all containers, **you can build just one**::
- $ sudo -H ./utils/lxc.sh build searx-ubu1804
+ $ sudo -H ./utils/lxc.sh build searxng-archlinux
*Good to know ...*
@@ -62,9 +62,9 @@ of::
In the containers, you can run what ever you want, e.g. to start a bash use::
- $ sudo -H ./utils/lxc.sh cmd searx-ubu1804 bash
- INFO: [searx-ubu1804] bash
- root@searx-ubu1804:/share/searx#
+ $ sudo -H ./utils/lxc.sh cmd searxng-archlinux bash
+ INFO: [searxng-archlinux] bash
+ [root@searxng-archlinux SearXNG]#
If there comes the time you want to **get rid off all** the containers and
**clean up local images** just type::
@@ -121,28 +121,26 @@ Install suite
=============
To install the complete :ref:`SearXNG suite (includes searx, morty & filtron)
-<lxc-searx.env>` into all LXC_ use::
+<lxc-searxng.env>` into all LXC_ use::
$ sudo -H ./utils/lxc.sh install suite
-The command above installs a SearXNG suite (see :ref:`installation scripts`). To
-get the IP (URL) of the filtron service in the containers use ``show suite``
+The command above installs a SearXNG suite (see :ref:`installation scripts`).
+To :ref:`install a nginx <installation nginx>` reverse proxy (or alternatively
+use :ref:`apache <installation apache>`)::
+
+ sudo -H ./utils/lxc.sh cmd -- FORCE_TIMEOUT=0 ./utils/searxng.sh install nginx
+
+To get the IP (URL) of the SearXNG service in the containers use ``show suite``
command. To test instances from containers just open the URLs in your
WEB-Browser::
- $ sudo ./utils/lxc.sh show suite | grep filtron
- [searx-ubu1604] INFO: (eth0) filtron: http://n.n.n.246:4004/ http://n.n.n.246/searx
- [searx-ubu1804] INFO: (eth0) filtron: http://n.n.n.147:4004/ http://n.n.n.147/searx
- [searx-ubu1910] INFO: (eth0) filtron: http://n.n.n.140:4004/ http://n.n.n.140/searx
- [searx-ubu2004] INFO: (eth0) filtron: http://n.n.n.18:4004/ http://n.n.n.18/searx
- [searx-fedora31] INFO: (eth0) filtron: http://n.n.n.46:4004/ http://n.n.n.46/searx
- [searx-archlinux] INFO: (eth0) filtron: http://n.n.n.32:4004/ http://n.n.n.32/searx
-
-To :ref:`install a nginx <installation nginx>` reverse proxy for filtron and
-morty use (or alternatively use :ref:`apache <installation apache>`)::
+ $ sudo ./utils/lxc.sh show suite | grep SEARXNG_URL
- sudo -H ./utils/lxc.sh cmd -- FORCE_TIMEOUT=0 ./utils/filtron.sh nginx install
- sudo -H ./utils/lxc.sh cmd -- FORCE_TIMEOUT=0 ./utils/morty.sh nginx install
+ [searxng-ubu2110] SEARXNG_URL : http://n.n.n.147/searxng
+ [searxng-ubu2004] SEARXNG_URL : http://n.n.n.246/searxng
+ [searxnggfedora35] SEARXNG_URL : http://n.n.n.140/searxng
+ [searxng-archlinux] SEARXNG_URL : http://n.n.n.165/searxng
Running commands
@@ -152,8 +150,8 @@ Running commands
:ref:`toolboxing`. By example: to setup a :ref:`buildhosts` and run the
Makefile target ``test`` in the archlinux_ container::
- sudo -H ./utils/lxc.sh cmd searx-archlinux ./utils/searx.sh install buildhost
- sudo -H ./utils/lxc.sh cmd searx-archlinux make test
+ sudo -H ./utils/lxc.sh cmd searxng-archlinux ./utils/searxng.sh install buildhost
+ sudo -H ./utils/lxc.sh cmd searxng-archlinux make test
Setup SearXNG buildhost
@@ -164,11 +162,11 @@ The installation procedure to set up a :ref:`build host<buildhosts>` takes its
time. Installation in all containers will take more time (time for another cup
of coffee).::
- sudo -H ./utils/lxc.sh cmd -- ./utils/searx.sh install buildhost
+ sudo -H ./utils/lxc.sh cmd -- ./utils/searxng.sh install buildhost
To build (live) documentation inside a archlinux_ container::
- sudo -H ./utils/lxc.sh cmd searx-archlinux make docs.clean docs.live
+ sudo -H ./utils/lxc.sh cmd searxng-archlinux make docs.clean docs.live
...
[I 200331 15:00:42 server:296] Serving on http://0.0.0.0:8080
@@ -176,7 +174,7 @@ To get IP of the container and the port number *live docs* is listening::
$ sudo ./utils/lxc.sh show suite | grep docs.live
...
- [searx-archlinux] INFO: (eth0) docs.live: http://n.n.n.12:8080/
+ [searxng-archlinux] INFO: (eth0) docs.live: http://n.n.n.12:8080/
.. _lxc.sh help:
@@ -189,10 +187,10 @@ The ``--help`` output of the script is largely self-explanatory:
.. program-output:: ../utils/lxc.sh --help
-.. _lxc-searx.env:
+.. _lxc-searxng.env:
SearXNG suite
=============
-.. literalinclude:: ../../utils/lxc-searx.env
+.. literalinclude:: ../../utils/lxc-searxng.env
:language: bash