codelibs · marevol · Sep 27, 2026 · Sep 27, 2026
diff --git a/de/15.9/admin/labeltype-guide.rst b/de/15.9/admin/labeltype-guide.rst
@@ -72,6 +72,14 @@ Virtueller Host
 Geben Sie den Hostnamen des virtuellen Hosts an.
 Weitere Details finden Sie unter :doc:`Virtueller Host im Konfigurationshandbuch <../config/security-virtual-host>`.
 
+Ein über einen virtuellen Host aufgerufener Suchbildschirm zeigt nur die Labels an, in deren Feld dieser virtuelle Host angegeben ist.
+Ein Label mit leerem Feld wird nicht angezeigt, wenn der Suchbildschirm über einen virtuellen Host aufgerufen wird.
+Bei einem Zugriff, der keinem virtuellen Host entspricht, werden unabhängig von diesem Feld alle Labels angezeigt.
+
+Pro Label kann nur ein virtueller Host angegeben werden.
+Um dasselbe Label auf mehreren virtuellen Hosts anzuzeigen, erstellen Sie für jeden virtuellen Host ein Label mit demselben Namen und Wert und tragen im Feld „Virtueller Host" jeweils dessen Namen ein.
+Da der Wert gleich ist, grenzt jedes dieser Labels auf dieselben Dokumente ein.
+
 Anzeigereihenfolge
 ::::::::::::::::::
 

diff --git a/de/15.9/admin/plugin-guide.rst b/de/15.9/admin/plugin-guide.rst
@@ -26,7 +26,14 @@ Um ein neues Plug-in zu installieren, klicken Sie auf die Schaltfläche „Insta
 
 |image1|
 
-Wählen Sie im Dropdown-Menü das zu installierende Plug-in aus und klicken Sie auf die Schaltfläche „Installieren", um die Installation zu starten.
+Wählen Sie im Dropdown-Menü auf der Registerkarte „Remote" das zu installierende Plug-in aus und klicken Sie auf die Schaltfläche „Installieren", um die Installation zu starten.
+Das Dropdown-Menü listet die Plug-ins aus den Plug-in-Repositorys (``plugin.repositories``) auf. Sind diese nicht erreichbar, wird „Keine verfügbaren Plugins gefunden." angezeigt.
+
+Um eine vorhandene JAR-Datei zu installieren, wählen Sie sie auf der Registerkarte „Lokal" unter „Jar-Datei" aus und klicken Sie auf die Schaltfläche „Installieren". Es werden nur Dateien mit der Endung ``.jar`` akzeptiert.
+Lassen Sie dabei das Dropdown-Menü auf der Registerkarte „Remote" auf dem ersten Eintrag (``-``); ist dort ein anderes Plug-in ausgewählt, wird stattdessen dieses installiert.
+Wie Sie Plug-ins ohne Internetzugang installieren, lesen Sie unter :ref:`fess-setup-offline`.
+
+Starten Sie |Fess| nach der Installation eines Plug-ins neu.
 
 Installation über die Befehlszeile
 ==================================

diff --git a/de/15.9/api/api-overview.rst b/de/15.9/api/api-overview.rst
@@ -135,7 +135,7 @@ Abhängig von ``error.code`` wird ein standardmäßiger HTTP-Statuscode zurückg
      - Nicht unterstützter ``Content-Type`` (die meisten Endpunkte erfordern ``application/json``).
    * - ``rate_limited``
      - 429
-     - Rate-Limit überschritten. Der ``Retry-After``-Header gibt die Wartezeit in Sekunden an.
+     - Das Versuchslimit eines Endpunkts, etwa für Anmeldung, Passwortänderung oder Chat, wurde überschritten. Der ``Retry-After``-Header gibt die Wartezeit in Sekunden an.
    * - ``internal_error``
      - 500
      - Interner Serverfehler aufgetreten.
@@ -150,6 +150,25 @@ Tabelle: Liste der Fehlercodes
    Bei einer ``method_not_allowed``-Antwort wird ein ``Allow``-Header
    beigefügt, der die unterstützten HTTP-Methoden auflistet.
 
+.. note::
+
+   Das serverweite Rate-Limit für HTTP-Anfragen (``rate.limit.enabled=true``, siehe :doc:`../config/rate-limiting`)
+   greift vor der v2-API; seine Antworten verwenden daher nicht das obige Envelope-Format.
+   Eine Anfrage über dem Limit erhält HTTP 429 mit einem ``Retry-After``-Header (``rate.limit.retry.after.seconds``,
+   Standard ``60``) und diesem Body:
+
+   ::
+
+       {"error":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds.","retry_after":60}
+
+   Eine IP-Adresse über dem Limit wird für ``rate.limit.block.duration.ms`` blockiert. Anfragen in dieser Zeit
+   (ebenso Anfragen von IP-Adressen in ``rate.limit.blocked.ips``) erhalten HTTP 403 mit diesem Body.
+   Diese Antwort hat keinen ``Retry-After``-Header.
+
+   ::
+
+       {"error":"ip_blocked","message":"Access denied."}
+
 Authentifizierung und Sitzung
 ==============================
 

diff --git a/de/15.9/config/crawler-advanced.rst b/de/15.9/config/crawler-advanced.rst
@@ -427,6 +427,26 @@ Beispiele für benutzerdefinierte XPath
     # Auch Meta-Keywords in Digest einbeziehen
     crawler.document.html.digest.xpath=//META[@name='description']/@content|//META[@name='keywords']/@content
 
+Dies sind systemweite Einstellungen, die für alle Web-Crawl-Konfigurationen gelten.
+
+.. note::
+
+   Eine Änderung wirkt sich auf Dokumente aus, sobald sie das nächste Mal gecrawlt und indexiert werden.
+   Ist in den allgemeinen Einstellungen „Letzte Änderung prüfen" (inkrementelles Crawling) aktiviert, wird
+   ein Dokument, das sich seit dem letzten Crawl nicht geändert hat (sein ``Last-Modified`` ist nicht neuer
+   als der Zeitpunkt der letzten Änderung im Index), beim erneuten Crawlen nicht wieder abgerufen und behält
+   den mit dem alten XPath extrahierten Inhalt. Um die Änderung auf bereits gecrawlte Dokumente anzuwenden,
+   bauen Sie den Index neu auf, zum Beispiel indem Sie diese Dokumente aus dem Index löschen und erneut crawlen.
+
+Um für eine einzelne Crawl-Konfiguration einen anderen XPath zu verwenden, geben Sie ihn in den
+„Konfigurationsparametern" der Web-Crawl-Konfiguration wie folgt an. Für diese Crawl-Konfiguration hat er
+Vorrang vor ``crawler.document.html.*.xpath``. Sprache und Digest lassen sich ebenso mit
+``field.xpath.default.lang`` und ``field.xpath.default.digest`` festlegen.
+
+::
+
+    field.xpath.default.content=//DIV[@id='main-content']
+
 HTML-Tag-Verarbeitung
 ---------------------
 

diff --git a/de/15.9/config/rate-limiting.rst b/de/15.9/config/rate-limiting.rst
@@ -39,7 +39,8 @@ Verhalten
 ---------
 
 - Anfragen, die das Rate-Limit überschreiten, geben HTTP 429 (Too Many Requests) zurück
-- Anfragen von IPs auf der Blockliste geben HTTP 403 (Forbidden) zurück
+- Anfragen von IPs, die wegen Überschreitung des Limits blockiert sind, sowie von IPs auf der Blockliste geben HTTP 403 (Forbidden) zurück
+- Der Antwort-Body ist JSON (``{"error":"rate_limit_exceeded",...,"retry_after":60}`` bei 429, ``{"error":"ip_blocked",...}`` bei 403). Eine 429-Antwort hat einen ``Retry-After``-Header
 - Limits werden pro IP-Adresse angewendet
 - Pro IP-Adresse beginnt das Fenster mit der ersten Anfrage; nach Ablauf der Fensterperiode wird der Zähler zurückgesetzt (Festes-Fenster-Verfahren)
 - Bei Überschreitung wird die IP für die Dauer von ``rate.limit.block.duration.ms`` blockiert

diff --git a/de/15.9/config/search-scroll.rst b/de/15.9/config/search-scroll.rst
@@ -106,8 +106,10 @@ Request-Parameter
 Für die Scroll-Suche können folgende Parameter verwendet werden:
 
 .. note::
-   Die Scroll-Suche unterstützt nur die GET-Methode. Bei Verwendung einer anderen HTTP-Methode
-   wird ``405 Method Not Allowed`` zurückgegeben.
+   Die Scroll-Suche unterstützt nur die GET-Methode. Bei zustandsändernden Methoden wie ``POST``
+   wird zuerst das CSRF-Token geprüft; eine Anfrage ohne gültigen ``X-Fess-CSRF-Token``-Header
+   erhält daher ``403 Forbidden`` (``forbidden``), siehe :doc:`../api/api-overview`.
+   Mit einem gültigen Token wird ``405 Method Not Allowed`` (``method_not_allowed``) zurückgegeben.
 
 .. list-table::
    :header-rows: 1

diff --git a/de/15.9/install/fess-setup.rst b/de/15.9/install/fess-setup.rst
@@ -201,6 +201,27 @@ remove plugin
 Löscht die installierten JARs der angegebenen Plugins. Ein Name, der nicht installiert ist, wird
 gemeldet und ändert den Exit-Code nicht.
 
+.. _fess-setup-offline:
+
+Umgebungen ohne Internetzugang
+------------------------------
+
+``install plugin``, ``list plugins`` und ``upgrade plugins`` beziehen Plugins aus Repositorys im
+Internet. Auch die Installationsseite unter **System > Plugin** in der Administrationsoberfläche
+bezieht die Liste der installierbaren Plugins aus den Repositorys (``plugin.repositories``) und kann
+sie daher ohne Zugang nach außen nicht anzeigen.
+
+Bringen Sie in einer solchen Umgebung die JARs der Plugins selbst mit:
+
+1. Laden Sie in einer Umgebung mit Internetzugang das |Fess|-ZIP-Paket und die JARs der benötigten
+   Plugins herunter. Ein JAR erhalten Sie unter
+   ``https://maven.codelibs.org/release/org/codelibs/fess/<name>/<version>/<name>-<version>.jar``.
+   Wählen Sie die Version für dieses |Fess| (15.9.x für |Fess| 15.9).
+2. Entpacken Sie in der Zielumgebung das ZIP und legen Sie die JARs in ``app/WEB-INF/plugin/`` ab.
+   Nach dem Start von |Fess| können Sie sie auch auf der Registerkarte „Lokal" der
+   Plugin-Installationsseite in der Administrationsoberfläche hochladen; siehe :doc:`../admin/plugin-guide`.
+3. Starten Sie |Fess|. Wenn Sie die JARs während des Betriebs abgelegt haben, starten Sie es neu.
+
 Themes verwalten
 ================
 

diff --git a/en/15.9/admin/labeltype-guide.rst b/en/15.9/admin/labeltype-guide.rst
@@ -71,6 +71,14 @@ Virtual Host
 Specifies the virtual host hostname.
 For details, refer to :doc:`Virtual Host in the Configuration Guide <../config/security-virtual-host>`.
 
+A search screen accessed through a virtual host shows only the labels whose field names that virtual host.
+A label with this field empty is not shown when the search screen is accessed through a virtual host.
+An access that matches no virtual host shows all labels, whatever this field holds.
+
+A label can name only one virtual host.
+To show the same label on several virtual hosts, create a label with the same name and value for each virtual host, and put that virtual host name in its Virtual Host field.
+Because the value is the same, each of those labels narrows the results to the same documents.
+
 Display Order
 :::::::::::::
 

diff --git a/en/15.9/admin/plugin-guide.rst b/en/15.9/admin/plugin-guide.rst
@@ -26,7 +26,14 @@ To install a new plugin, click the Install button.
 
 |image1|
 
-Select the plugin you want to install from the pull-down menu and click the Install button to start the installation.
+Select the plugin you want to install from the pull-down menu on the "Remote" tab and click the Install button to start the installation.
+The pull-down menu lists the plugins in the plugin repositories (``plugin.repositories``). If they cannot be reached, "Could not find available plugins." is shown.
+
+To install a jar file you have, choose it in "Jar File" on the "Local" tab and click the Install button. Only files with the ``.jar`` extension are accepted.
+Leave the pull-down menu on the "Remote" tab at its first entry (``-``); if another plugin is selected there, that plugin is installed instead.
+To install plugins where there is no Internet access, see :ref:`fess-setup-offline`.
+
+Restart |Fess| after installing a plugin.
 
 Installing from the Command Line
 ================================

diff --git a/en/15.9/api/api-overview.rst b/en/15.9/api/api-overview.rst
@@ -134,7 +134,7 @@ The default HTTP status code is determined by ``error.code``.
      - The ``Content-Type`` is not supported (most endpoints require ``application/json``).
    * - ``rate_limited``
      - 429
-     - The rate limit has been exceeded. The ``Retry-After`` header indicates the number of seconds to wait.
+     - A per-endpoint attempt limit, such as for login, password change or chat, has been exceeded. The ``Retry-After`` header indicates the number of seconds to wait.
    * - ``internal_error``
      - 500
      - An internal server error occurred.
@@ -149,6 +149,25 @@ Table: Error Code List
    Responses with ``method_not_allowed`` include an ``Allow`` header listing
    the supported HTTP methods.
 
+.. note::
+
+   The server-wide HTTP request rate limit (``rate.limit.enabled=true``; see :doc:`../config/rate-limiting`)
+   is applied before the v2 API, so its responses do not use the envelope above.
+   A request over the limit gets HTTP 429 with a ``Retry-After`` header (``rate.limit.retry.after.seconds``,
+   default ``60``) and this body:
+
+   ::
+
+       {"error":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds.","retry_after":60}
+
+   An IP address over the limit is blocked for ``rate.limit.block.duration.ms``. Requests during that time
+   (and requests from IP addresses in ``rate.limit.blocked.ips``) get HTTP 403 with this body.
+   This response has no ``Retry-After`` header.
+
+   ::
+
+       {"error":"ip_blocked","message":"Access denied."}
+
 Authentication and Sessions
 ===========================
 

diff --git a/en/15.9/config/crawler-advanced.rst b/en/15.9/config/crawler-advanced.rst
@@ -429,6 +429,26 @@ Custom XPath Examples
     # Include meta keywords in digest
     crawler.document.html.digest.xpath=//META[@name='description']/@content|//META[@name='keywords']/@content
 
+These are system-wide settings and apply to every web crawl configuration.
+
+.. note::
+
+   A change applies to documents from the next time they are crawled and indexed.
+   When "Check Last Modified" (incremental crawling) is enabled in the General settings, a document
+   that has not changed since the last crawl (its ``Last-Modified`` is not newer than the last-modified
+   time in the index) is not fetched again on a recrawl, and keeps the content extracted with the old
+   XPath. To apply the change to documents already crawled, rebuild the index, for example by deleting
+   those documents from the index and crawling again.
+
+To use a different XPath for one crawl configuration, set it in "Configuration Parameters" of the web
+crawl configuration as follows. For that crawl configuration, it takes precedence over
+``crawler.document.html.*.xpath``. The language and digest can be set the same way with
+``field.xpath.default.lang`` and ``field.xpath.default.digest``.
+
+::
+
+    field.xpath.default.content=//DIV[@id='main-content']
+
 HTML Tag Processing
 -------------------
 

diff --git a/en/15.9/config/rate-limiting.rst b/en/15.9/config/rate-limiting.rst
@@ -39,7 +39,8 @@ Behavior
 --------
 
 - Requests exceeding the rate limit return HTTP 429 (Too Many Requests)
-- Requests from IPs on the blocked IP list return HTTP 403 (Forbidden)
+- Requests from IPs blocked for exceeding the limit, and from IPs on the blocked IP list, return HTTP 403 (Forbidden)
+- The response body is JSON (``{"error":"rate_limit_exceeded",...,"retry_after":60}`` for 429, ``{"error":"ip_blocked",...}`` for 403). A 429 response has a ``Retry-After`` header
 - Limits are applied per IP address
 - For each IP, the counting window starts from the first request and resets after the window period expires (fixed window algorithm)
 - When the limit is exceeded, the IP is blocked for the duration specified by ``rate.limit.block.duration.ms``

diff --git a/en/15.9/config/search-scroll.rst b/en/15.9/config/search-scroll.rst
@@ -100,8 +100,10 @@ Request Parameters
 The following parameters can be used with scroll search:
 
 .. note::
-   Scroll search only supports the GET method. Accessing with any method other than GET returns
-   ``405 Method Not Allowed``.
+   Scroll search only supports the GET method. For a state-changing method such as ``POST``,
+   the CSRF token is checked first, so a request without a valid ``X-Fess-CSRF-Token`` header
+   gets ``403 Forbidden`` (``forbidden``); see :doc:`../api/api-overview`.
+   With a valid token, it gets ``405 Method Not Allowed`` (``method_not_allowed``).
 
 .. list-table::
    :header-rows: 1

diff --git a/en/15.9/install/fess-setup.rst b/en/15.9/install/fess-setup.rst
@@ -189,6 +189,27 @@ remove plugin
 Deletes the installed jars of the named plugins. A name that is not installed is reported, and does
 not change the exit code.
 
+.. _fess-setup-offline:
+
+Without Internet Access
+-----------------------
+
+``install plugin``, ``list plugins`` and ``upgrade plugins`` get plugins from repositories on the
+Internet. The install page under System > Plugin in the administration screen also gets the list of
+installable plugins from the repositories (``plugin.repositories``), so it cannot show the list where
+there is no outside access.
+
+In such an environment, bring in the plugin jars:
+
+1. Where there is Internet access, download the |Fess| ZIP package and the jars of the plugins you need.
+   A jar can be downloaded from
+   ``https://maven.codelibs.org/release/org/codelibs/fess/<name>/<version>/<name>-<version>.jar``.
+   Choose the version for this |Fess| (15.9.x for |Fess| 15.9).
+2. In the target environment, extract the ZIP and put the jars in ``app/WEB-INF/plugin/``. After |Fess|
+   starts, you can also upload them on the "Local" tab of the plugin install page in the administration
+   screen; see :doc:`../admin/plugin-guide`.
+3. Start |Fess|. If you put the jars there while it was running, restart it.
+
 Managing Themes
 ===============
 

diff --git a/es/15.9/admin/labeltype-guide.rst b/es/15.9/admin/labeltype-guide.rst
@@ -72,6 +72,14 @@ Host virtual
 Especifique el nombre de host del host virtual.
 Para más detalles, consulte :doc:`Host virtual en la guía de configuración <../config/security-virtual-host>`.
 
+En una pantalla de búsqueda a la que se accede mediante un host virtual solo se muestran las etiquetas cuyo campo especifica el nombre de ese host virtual.
+Las etiquetas con este campo vacío no se muestran cuando se accede mediante un host virtual.
+En los accesos que no coinciden con ningún host virtual se muestran todas las etiquetas, independientemente de este campo.
+
+Cada etiqueta admite un solo host virtual.
+Para mostrar la misma etiqueta en varios hosts virtuales, cree una etiqueta con el mismo nombre y valor para cada host virtual e indique en el campo de host virtual de cada una el nombre de ese host virtual.
+Como el valor es el mismo, cualquiera de las etiquetas filtra los mismos documentos.
+
 Orden de clasificación
 ::::::::::::::::::::::
 

diff --git a/es/15.9/admin/plugin-guide.rst b/es/15.9/admin/plugin-guide.rst
@@ -26,7 +26,14 @@ Para instalar un nuevo complemento, haga clic en el botón de instalación.
 
 |image1|
 
-Seleccione el complemento que desea instalar en el menú desplegable y haga clic en el botón de instalación para comenzar la instalación.
+Seleccione el complemento que desea instalar en el menú desplegable de la pestaña «Remoto» y haga clic en el botón de instalación para comenzar la instalación.
+La lista del menú desplegable se obtiene de los repositorios de plugins (``plugin.repositories``). Si no se puede conectar con los repositorios, se muestra «No se encontraron plugins disponibles.».
+
+Para instalar un archivo jar local, selecciónelo en «Archivo Jar» de la pestaña «Local» y haga clic en el botón de instalación. Solo se pueden indicar archivos con la extensión ``.jar``.
+Deje el menú desplegable de la pestaña «Remoto» en su primera opción (``-``). Si hay otro complemento seleccionado, se instala ese en su lugar.
+Para instalar en un entorno sin conexión a Internet, consulte :ref:`fess-setup-offline`.
+
+Reinicie |Fess| después de instalar un complemento.
 
 Instalación desde la línea de comandos
 ======================================

diff --git a/es/15.9/api/api-overview.rst b/es/15.9/api/api-overview.rst
@@ -134,7 +134,7 @@ El código de estado HTTP predeterminado se determina según ``error.code``.
      - ``Content-Type`` no admitido (la mayoría de los endpoints requieren ``application/json``).
    * - ``rate_limited``
      - 429
-     - Se superó el límite de velocidad. La cabecera ``Retry-After`` indica los segundos que se deben esperar.
+     - Se superó el límite de intentos propio de un endpoint, como el inicio de sesión, el cambio de contraseña o el chat. La cabecera ``Retry-After`` indica los segundos que se deben esperar.
    * - ``internal_error``
      - 500
      - Se produjo un error interno en el servidor.
@@ -149,6 +149,25 @@ Tabla: Lista de códigos de error
    La respuesta ``method_not_allowed`` incluye una cabecera ``Allow`` que enumera
    los métodos HTTP admitidos.
 
+.. note::
+
+   El límite de velocidad de solicitudes HTTP de todo el servidor (``rate.limit.enabled=true``, consulte
+   :doc:`../config/rate-limiting`) se aplica antes que la API v2, por lo que su respuesta no usa el
+   formato de sobre anterior. Una solicitud que supera el límite recibe HTTP 429 con la cabecera
+   ``Retry-After`` (``rate.limit.retry.after.seconds``, por defecto ``60``) y este cuerpo:
+
+   ::
+
+       {"error":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds.","retry_after":60}
+
+   La dirección IP que supera el límite queda bloqueada durante ``rate.limit.block.duration.ms``, y las
+   solicitudes durante ese tiempo (igual que las de las direcciones IP incluidas en ``rate.limit.blocked.ips``)
+   reciben HTTP 403 con el cuerpo siguiente. Esta respuesta no incluye la cabecera ``Retry-After``.
+
+   ::
+
+       {"error":"ip_blocked","message":"Access denied."}
+
 Autenticación y sesión
 ======================