From: Trenton Holmes <797416+stumpylog@users.noreply.github.com>
Date: Wed, 30 Nov 2022 04:06:56 +0000 (-0800)
Subject: Expands documentation around the permissions of the custom scripts and the folder
X-Git-Tag: v1.10.1~1^2~8
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4e90fda80f651d67016795d8b273f34a44da880f;p=thirdparty%2Fpaperless-ngx.git

Expands documentation around the permissions of the custom scripts and the folder
---

diff --git a/docs/advanced_usage.rst b/docs/advanced_usage.rst
index 1fe3e36858..61b5f33232 100644
--- a/docs/advanced_usage.rst
+++ b/docs/advanced_usage.rst
@@ -407,11 +407,14 @@ The Docker image includes the ability to run custom user scripts during startup.
 utilized for installing additional tools or Python packages, for example.
 
 To utilize this, mount a folder containing your scripts to the custom initialization directory, `/custom-cont-init.d`
-and place scripts you wish to run inside.  For security, the folder and its contents must be owned by `root`.
-Additionally, scripts must only be writable by `root`.
+and place scripts you wish to run inside.  For security, the folder must be owned by `root` and should have permissions
+of `a=rx`.  Additionally, scripts must only be writable by `root`.
 
 Your scripts will be run directly before the webserver completes startup.  Scripts will be run by the `root` user.
-This is an advanced functionality with which you could break functionality or lose data.
+If you would like to switch users, the utility `gosu` is available and preferred over `sudo`.
+
+This is an advanced functionality with which you could break functionality or lose data.  If you experience issues,
+please disable any custom scripts and try again before reporting an issue.
 
 For example, using Docker Compose:
 
@@ -425,6 +428,7 @@ For example, using Docker Compose:
         volumes:
           - /path/to/my/scripts:/custom-cont-init.d:ro
 
+
 .. _advanced-mysql-caveats:
 
 MySQL Caveats