]> git.ipfire.org Git - thirdparty/knot-resolver.git/commitdiff
doc/user/config-network-server-tls.rst: added info about 'files-watchdog' configuration
authorAleš Mrázek <ales.mrazek@nic.cz>
Mon, 6 Jan 2025 15:24:31 +0000 (16:24 +0100)
committerAleš Mrázek <ales.mrazek@nic.cz>
Tue, 14 Jan 2025 09:03:29 +0000 (10:03 +0100)
doc/user/config-network-server-tls.rst

index 8fc848786a63450afcf3daa3be17a9169968842e..ea63482f736c9d5f13fafffa6011b417e902156f 100644 (file)
@@ -128,14 +128,22 @@ policies.
           cert-file: /etc/knot-resolver/server-cert.pem
           key-file: /etc/knot-resolver/server-key.pem
 
-   .. tip::
+   .. option:: files-watchdog: auto|true|false
 
-      If you have ``python-watchdog`` installed on your system,
+      :default: auto
+
+      By default, if you have ``python-watchdog`` installed on your system,
       the certificate files are automatically reloaded on change.
-      If you update the certificate files, e.g. using ACME,
-      the manager is notified about changes and commands all workers
-      to reload their certificate files. If you don't have ``python-watchdog``,
-      you have to restart the ``knot-resolver`` service manually.
+      When you update the certificate files, e.g. using ACME,
+      the manager is notified of the changes and commands all workers
+      to reload their certificate files.
+
+      If you don't have ``python-watchdog`` installed, this feature is not available
+      and you will have to restart the ``knot-resolver`` service manually.
+
+      You can also manually enable (``true``) and disable (``false``) this feature in the config,
+      but if it is enabled and ``python-watchdog`` is not installed,
+      the resolver will fail to start with a configuration validation error.
 
    .. option:: sticket-secret: <str>