summaryrefslogtreecommitdiff
path: root/docs/admin
diff options
context:
space:
mode:
authorMarkus Heiser <markus.heiser@darmarit.de>2021-11-18 18:27:26 +0100
committerMarkus Heiser <markus.heiser@darmarit.de>2021-11-18 18:27:26 +0100
commit1dae0c0be09d5c9e287bdea6aa5bf7ec4f4782ec (patch)
tree979a544e2853918f8a887480abe940e6880ae84c /docs/admin
parent27bb55ab0729fe0531440362f6aa5eb1142e42fb (diff)
downloadsearxng-1dae0c0be09d5c9e287bdea6aa5bf7ec4f4782ec.tar.gz
searxng-1dae0c0be09d5c9e287bdea6aa5bf7ec4f4782ec.zip
[brand] SearXNG - docs rename links and fix documentation
Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
Diffstat (limited to 'docs/admin')
-rw-r--r--docs/admin/architecture.rst12
-rw-r--r--docs/admin/engines/settings.rst4
-rw-r--r--docs/admin/engines/sql-engines.rst4
-rw-r--r--docs/admin/filtron.rst8
-rw-r--r--docs/admin/index.rst4
-rw-r--r--docs/admin/installation-apache.rst24
-rw-r--r--docs/admin/installation-docker.rst4
-rw-r--r--docs/admin/installation-nginx.rst18
-rw-r--r--docs/admin/installation-searxng.rst (renamed from docs/admin/installation-searx.rst)16
-rw-r--r--docs/admin/installation-uwsgi.rst26
-rw-r--r--docs/admin/installation.rst10
-rw-r--r--docs/admin/morty.rst8
-rw-r--r--docs/admin/update-searxng.rst (renamed from docs/admin/update-searx.rst)4
13 files changed, 71 insertions, 71 deletions
diff --git a/docs/admin/architecture.rst b/docs/admin/architecture.rst
index 45d952282..db99c9f55 100644
--- a/docs/admin/architecture.rst
+++ b/docs/admin/architecture.rst
@@ -6,12 +6,12 @@ Architecture
.. sidebar:: Further reading
- - Reverse Proxy: :ref:`Apache <apache searx site>` & :ref:`nginx <nginx searx
- site>`
- - Filtron: :ref:`searx filtron`
- - Morty: :ref:`searx morty`
- - uWSGI: :ref:`searx uwsgi`
- - Searx: :ref:`installation basic`
+ - Reverse Proxy: :ref:`Apache <apache searxng site>` & :ref:`nginx <nginx
+ searxng site>`
+ - Filtron: :ref:`searxng filtron`
+ - Morty: :ref:`searxng morty`
+ - uWSGI: :ref:`searxng uwsgi`
+ - SearXNG: :ref:`installation basic`
Herein you will find some hints and suggestions about typical architectures of
SearXNG infrastructures.
diff --git a/docs/admin/engines/settings.rst b/docs/admin/engines/settings.rst
index c67b45669..b04de7cb3 100644
--- a/docs/admin/engines/settings.rst
+++ b/docs/admin/engines/settings.rst
@@ -94,7 +94,7 @@ Global Settings
port: 8888
bind_address: "127.0.0.1" # address to listen on
secret_key: "ultrasecretkey" # change this!
- image_proxy: false # proxying image results through searx
+ image_proxy: false # proxying image results through SearXNG
default_locale: "" # default interface locale
default_theme: oscar # ui theme
default_http_headers:
@@ -293,7 +293,7 @@ engine is shown. Most of the options have a default value or even are optional.
``timeout`` : optional
Timeout of the search with the current search engine. **Be careful, it will
- modify the global timeout of searx.**
+ modify the global timeout of SearXNG.**
``api_key`` : optional
In a few cases, using an API needs the use of a secret key. How to obtain them
diff --git a/docs/admin/engines/sql-engines.rst b/docs/admin/engines/sql-engines.rst
index 713ef9a40..9d24913a9 100644
--- a/docs/admin/engines/sql-engines.rst
+++ b/docs/admin/engines/sql-engines.rst
@@ -127,7 +127,7 @@ find an example configuration below:
- name: my_database
engine: postgresql
database: my_database
- username: searx
+ username: searxng
password: password
query_str: 'SELECT * from my_table WHERE my_column = %(query)s'
@@ -155,7 +155,7 @@ example configuration for quering a MySQL server:
- name: my_database
engine: mysql_server
database: my_database
- username: searx
+ username: searxng
password: password
limit: 5
query_str: 'SELECT * from my_table WHERE my_column=%(query)s'
diff --git a/docs/admin/filtron.rst b/docs/admin/filtron.rst
index dd3cfc675..1c32c1b37 100644
--- a/docs/admin/filtron.rst
+++ b/docs/admin/filtron.rst
@@ -1,5 +1,5 @@
-.. _searx filtron:
+.. _searxng filtron:
==========================
How to protect an instance
@@ -8,7 +8,7 @@ How to protect an instance
.. sidebar:: further reading
- :ref:`filtron.sh`
- - :ref:`nginx searx site`
+ - :ref:`nginx searxng site`
.. contents:: Contents
@@ -19,7 +19,7 @@ How to protect an instance
.. _filtron: https://github.com/asciimoo/filtron
SearXNG depends on external search services. To avoid the abuse of these services
-it is advised to limit the number of requests processed by searx.
+it is advised to limit the number of requests processed by SearXNG.
An application firewall, filtron_ solves exactly this problem. Filtron is just
a middleware between your web server (nginx, apache, ...) and searx, we describe
@@ -188,4 +188,4 @@ Use it along with ``nginx`` with the following example configuration.
Requests are coming from port 4004 going through filtron and then forwarded to
port 8888 where a SearXNG is being run. For a complete setup see: :ref:`nginx
-searx site`.
+searxng site`.
diff --git a/docs/admin/index.rst b/docs/admin/index.rst
index 3139db99c..940707d8f 100644
--- a/docs/admin/index.rst
+++ b/docs/admin/index.rst
@@ -7,12 +7,12 @@ Administrator documentation
:caption: Contents
installation
- installation-searx
+ installation-searxng
installation-uwsgi
installation-nginx
installation-apache
installation-docker
- update-searx
+ update-searxng
engines/index
api
architecture
diff --git a/docs/admin/installation-apache.rst b/docs/admin/installation-apache.rst
index c15e3f5a0..b60e20ad1 100644
--- a/docs/admin/installation-apache.rst
+++ b/docs/admin/installation-apache.rst
@@ -47,13 +47,13 @@ Install with apache
----
-**Install** :ref:`apache searx site` using :ref:`filtron.sh <filtron.sh overview>`
+**Install** :ref:`apache searxng site` using :ref:`filtron.sh <filtron.sh overview>`
.. code:: bash
$ sudo -H ./utils/filtron.sh apache install
-**Install** :ref:`apache searx site` using :ref:`morty.sh <morty.sh overview>`
+**Install** :ref:`apache searxng site` using :ref:`morty.sh <morty.sh overview>`
.. code:: bash
@@ -163,7 +163,7 @@ How this default intro site is configured, depends on the linux distribution
less /etc/httpd/conf.d/welcome.conf
-.. _apache searx site:
+.. _apache searxng site:
Apache Reverse Proxy
====================
@@ -192,14 +192,14 @@ except in :ref:`The Debian Layout`.
sudo -H a2enmod proxy
sudo -H a2enmod proxy_http
- In :ref:`The Debian Layout` you create a ``searx.conf`` with the
+ In :ref:`The Debian Layout` you create a ``searxng.conf`` with the
``<Location /searx >`` directive and save this file in the *sites
available* folder at ``/etc/apache2/sites-available``. To enable the
- ``searx.conf`` use :man:`a2ensite`:
+ ``searxng.conf`` use :man:`a2ensite`:
.. code:: sh
- sudo -H a2ensite searx.conf
+ sudo -H a2ensite searxng.conf
.. group-tab:: Arch Linux
@@ -230,7 +230,7 @@ except in :ref:`The Debian Layout`.
With ProxyPreserveHost_ the incoming Host HTTP request header is passed to the
proxied host.
-.. _apache searx via filtron plus morty:
+.. _apache searxng via filtron plus morty:
.. tabs::
@@ -262,7 +262,7 @@ proxied host.
</Location>
- 2. Configure reverse proxy for :ref:`morty <searx morty>`, listening on
+ 2. Configure reverse proxy for :ref:`morty <searxng morty>`, listening on
*localhost 3000*
.. code:: apache
@@ -286,7 +286,7 @@ proxied host.
</Location>
- For a fully result proxification add :ref:`morty's <searx morty>` **public
+ For a fully result proxification add :ref:`morty's <searxng morty>` **public
URL** to your :origin:`searx/settings.yml`:
.. code:: yaml
@@ -302,10 +302,10 @@ proxied host.
uWSGI support
=============
-Be warned, with this setup, your instance isn't :ref:`protected <searx
+Be warned, with this setup, your instance isn't :ref:`protected <searxng
filtron>`, nevertheless it is good enough for intranet usage. In modern Linux
distributions, the `mod_proxy_uwsgi`_ is compiled into the *normal* apache
-package and you need to install only the :ref:`uWSGI <searx uwsgi>` package:
+package and you need to install only the :ref:`uWSGI <searxng uwsgi>` package:
.. tabs::
@@ -337,7 +337,7 @@ For socket communication, you have to activate ``socket =
/run/uwsgi/app/searx/socket`` and comment out the ``http = 127.0.0.1:8888``
configuration in your :ref:`uwsgi ini file <uwsgi configuration>`. If not
already exists, create a folder for the unix sockets, which can be used by the
-searx account (see :ref:`create searx user`):
+SearXNG account (see :ref:`create searxng user`):
.. code:: bash
diff --git a/docs/admin/installation-docker.rst b/docs/admin/installation-docker.rst
index ecf9c833f..cd91af382 100644
--- a/docs/admin/installation-docker.rst
+++ b/docs/admin/installation-docker.rst
@@ -25,8 +25,8 @@ Docker installation
If you intend to create a public instance using Docker, use our well
maintained searxng-docker_ image which includes
- - :ref:`protection <searx filtron>` `[filtron]`_,
- - a :ref:`result proxy <searx morty>` `[morty]`_ and
+ - :ref:`protection <searxng filtron>` `[filtron]`_,
+ - a :ref:`result proxy <searxng morty>` `[morty]`_ and
- a HTTPS reverse proxy `[caddy]`_.
Make sure you have `installed Docker <https://docs.docker.com/get-docker/>`_ and
diff --git a/docs/admin/installation-nginx.rst b/docs/admin/installation-nginx.rst
index 1d982bc8f..fdbcdf032 100644
--- a/docs/admin/installation-nginx.rst
+++ b/docs/admin/installation-nginx.rst
@@ -34,13 +34,13 @@ Install with nginx
----
-**Install** :ref:`nginx searx site` using :ref:`filtron.sh <filtron.sh overview>`
+**Install** :ref:`nginx searxng site` using :ref:`filtron.sh <filtron.sh overview>`
.. code:: bash
$ sudo -H ./utils/filtron.sh nginx install
-**Install** :ref:`nginx searx site` using :ref:`morty.sh <morty.sh overview>`
+**Install** :ref:`nginx searxng site` using :ref:`morty.sh <morty.sh overview>`
.. code:: bash
@@ -126,7 +126,7 @@ depends on the linux distribution:
include /etc/nginx/conf.d/*.conf;
-.. _nginx searx site:
+.. _nginx searxng site:
A nginx SearXNG site
====================
@@ -163,7 +163,7 @@ Started wiki`_ is always a good resource *to keep in the pocket*.
Create configuration at ``/etc/nginx/conf.d/searxng`` and place a
symlink to sites-enabled:
-.. _nginx searx via filtron plus morty:
+.. _nginx searxng via filtron plus morty:
.. tabs::
@@ -195,7 +195,7 @@ Started wiki`_ is always a good resource *to keep in the pocket*.
}
- 2. Configure reverse proxy for :ref:`morty <searx morty>`, listening on
+ 2. Configure reverse proxy for :ref:`morty <searxng morty>`, listening on
*localhost 3000*:
.. code:: nginx
@@ -212,7 +212,7 @@ Started wiki`_ is always a good resource *to keep in the pocket*.
proxy_set_header X-Scheme $scheme;
}
- For a fully result proxification add :ref:`morty's <searx morty>` **public
+ For a fully result proxification add :ref:`morty's <searxng morty>` **public
URL** to your :origin:`searx/settings.yml`:
.. code:: yaml
@@ -228,7 +228,7 @@ Started wiki`_ is always a good resource *to keep in the pocket*.
.. group-tab:: proxy or uWSGI
- Be warned, with this setup, your instance isn't :ref:`protected <searx
+ Be warned, with this setup, your instance isn't :ref:`protected <searxng
filtron>`. Nevertheless it is good enough for intranet usage and it is a
excellent example of; *how different services can be set up*. The next
example shows a reverse proxy configuration wrapping the :ref:`searx-uWSGI
@@ -281,7 +281,7 @@ Started wiki`_ is always a good resource *to keep in the pocket*.
}
If not already exists, create a folder for the unix sockets, which can be
- used by the searx account:
+ used by the SearXNG account:
.. code:: bash
@@ -290,7 +290,7 @@ Started wiki`_ is always a good resource *to keep in the pocket*.
.. group-tab:: \.\. at subdir URL
- Be warned, with these setups, your instance isn't :ref:`protected <searx
+ Be warned, with these setups, your instance isn't :ref:`protected <searxng
filtron>`. The examples are just here to demonstrate how to export the
SearXNG application from a subdirectory URL ``https://example.org/searx/``.
diff --git a/docs/admin/installation-searx.rst b/docs/admin/installation-searxng.rst
index 3aa655e85..b14139310 100644
--- a/docs/admin/installation-searx.rst
+++ b/docs/admin/installation-searxng.rst
@@ -23,9 +23,9 @@ Install packages
.. hint::
- This installs also the packages needed by :ref:`searx uwsgi`
+ This installs also the packages needed by :ref:`searxng uwsgi`
-.. _create searx user:
+.. _create searxng user:
Create user
===========
@@ -42,8 +42,8 @@ Install SearXNG & dependencies
Start a interactive shell from new created user and clone searx:
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
- :start-after: START clone searx
- :end-before: END clone searx
+ :start-after: START clone searxng
+ :end-before: END clone searxng
In the same shell create *virtualenv*:
@@ -87,8 +87,8 @@ For a *minimal setup*, configure like shown below – replace ``searx@$(uname
``/etc/searxng/settings.yml`` to your needs.
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
- :start-after: START searx config
- :end-before: END searx config
+ :start-after: START searxng config
+ :end-before: END searxng config
.. tabs::
@@ -111,8 +111,8 @@ SearXNG looks at the exported environment ``$SEARXNG_SETTINGS_PATH`` for a
configuration file.
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
- :start-after: START check searx installation
- :end-before: END check searx installation
+ :start-after: START check searxng installation
+ :end-before: END check searxng installation
If everything works fine, hit ``[CTRL-C]`` to stop the *webapp* and disable the
debug option in ``settings.yml``. You can now exit SearXNG user bash (enter exit
diff --git a/docs/admin/installation-uwsgi.rst b/docs/admin/installation-uwsgi.rst
index 1fb24ca8f..1021283f9 100644
--- a/docs/admin/installation-uwsgi.rst
+++ b/docs/admin/installation-uwsgi.rst
@@ -1,4 +1,4 @@
-.. _searx uwsgi:
+.. _searxng uwsgi:
=====
uwsgi
@@ -105,24 +105,24 @@ restart the uwsgi application.
.. group-tab:: Ubuntu / debian
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
- :start-after: START searx uwsgi-description ubuntu-20.04
- :end-before: END searx uwsgi-description ubuntu-20.04
+ :start-after: START searxng uwsgi-description ubuntu-20.04
+ :end-before: END searxng uwsgi-description ubuntu-20.04
.. hotfix: a bug group-tab need this comment
.. group-tab:: Arch Linux
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
- :start-after: START searx uwsgi-description arch
- :end-before: END searx uwsgi-description arch
+ :start-after: START searxng uwsgi-description arch
+ :end-before: END searxng uwsgi-description arch
.. hotfix: a bug group-tab need this comment
.. group-tab:: Fedora / RHEL
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
- :start-after: START searx uwsgi-description fedora
- :end-before: END searx uwsgi-description fedora
+ :start-after: START searxng uwsgi-description fedora
+ :end-before: END searxng uwsgi-description fedora
.. tabs::
@@ -130,21 +130,21 @@ restart the uwsgi application.
.. group-tab:: Ubuntu / debian
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
- :start-after: START searx uwsgi-appini ubuntu-20.04
- :end-before: END searx uwsgi-appini ubuntu-20.04
+ :start-after: START searxng uwsgi-appini ubuntu-20.04
+ :end-before: END searxng uwsgi-appini ubuntu-20.04
.. hotfix: a bug group-tab need this comment
.. group-tab:: Arch Linux
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
- :start-after: START searx uwsgi-appini arch
- :end-before: END searx uwsgi-appini arch
+ :start-after: START searxng uwsgi-appini arch
+ :end-before: END searxng uwsgi-appini arch
.. hotfix: a bug group-tab need this comment
.. group-tab:: Fedora / RHEL
.. kernel-include:: $DOCS_BUILD/includes/searx.rst
- :start-after: START searx uwsgi-appini fedora
- :end-before: END searx uwsgi-appini fedora
+ :start-after: START searxng uwsgi-appini fedora
+ :end-before: END searxng uwsgi-appini fedora
diff --git a/docs/admin/installation.rst b/docs/admin/installation.rst
index 59f142aff..ccb5314c1 100644
--- a/docs/admin/installation.rst
+++ b/docs/admin/installation.rst
@@ -27,7 +27,7 @@ Installation scripts
.. sidebar:: Update OS first!
- To avoid unwanted side effects, update your OS before installing searx.
+ To avoid unwanted side effects, update your OS before installing SearXNG.
The following will install a setup as shown in :ref:`architecture`. First you
need to get a clone. The clone is only needed for the installation procedure
@@ -42,14 +42,14 @@ the case if you clone into a folder below ``/root``.
.. code:: bash
$ cd ~/Downloads
- $ git clone https://github.com/searxng/searxng.git searx
- $ cd searx
+ $ git clone https://github.com/searxng/searxng.git searxng
+ $ cd searxng
.. sidebar:: further read
- :ref:`toolboxing`
- - :ref:`update searx`
- - :ref:`inspect searx`
+ - :ref:`update searxng`
+ - :ref:`inspect searxng`
**Install** :ref:`SearXNG service <searx.sh>`
diff --git a/docs/admin/morty.rst b/docs/admin/morty.rst
index d19a91361..b6bd2ea56 100644
--- a/docs/admin/morty.rst
+++ b/docs/admin/morty.rst
@@ -1,5 +1,5 @@
-.. _searx morty:
+.. _searxng morty:
=========================
How to setup result proxy
@@ -15,7 +15,7 @@ How to setup result proxy
By default SearXNG can only act as an image proxy for result images, but it is
possible to proxify all the result URLs with an external service, morty_.
-To use this feature, morty has to be installed and activated in searx's
+To use this feature, morty has to be installed and activated in SearXNG's
``settings.yml``. Add the following snippet to your ``settings.yml`` and
restart searx:
@@ -30,8 +30,8 @@ instances without a HTTP proxy. If your morty service is public, the url is the
address of the reverse proxy (e.g ``https://example.org/morty``).
For more information about *result proxy* have a look at *"SearXNG via filtron
-plus morty"* in the :ref:`nginx <nginx searx via filtron plus morty>` and
-:ref:`apache <apache searx via filtron plus morty>` sections.
+plus morty"* in the :ref:`nginx <nginx searxng via filtron plus morty>` and
+:ref:`apache <apache searxng via filtron plus morty>` sections.
``url``
Is the address of the running morty service.
diff --git a/docs/admin/update-searx.rst b/docs/admin/update-searxng.rst
index ea58a9954..4c541bf57 100644
--- a/docs/admin/update-searx.rst
+++ b/docs/admin/update-searxng.rst
@@ -1,4 +1,4 @@
-.. _update searx:
+.. _update searxng:
=============
How to update
@@ -25,7 +25,7 @@ How to update depends on the :ref:`installation` method. If you have used the
$ sudo -H ./utils/morty.sh update morty
-.. _inspect searx:
+.. _inspect searxng:
======================
How to inspect & debug