From: Michael Shamoon <4887959+shamoon@users.noreply.github.com>
Date: Wed, 30 Nov 2022 05:20:45 +0000 (-0800)
Subject: Add changes from #2069
X-Git-Tag: v1.10.2~12^2~2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3ee1d2a9a9a3a78e9254850f0d4a9f98664cc5dd;p=thirdparty%2Fpaperless-ngx.git

Add changes from #2069
---

diff --git a/docs/advanced_usage.md b/docs/advanced_usage.md
index 1d66ad9185..cdc8aa7197 100644
--- a/docs/advanced_usage.md
+++ b/docs/advanced_usage.md
@@ -424,14 +424,18 @@ Python packages, for example.
 
 To utilize this, mount a folder containing your scripts to the custom
 initialization directory, [/custom-cont-init.d]{.title-ref} and place
-scripts you wish to run inside. For security, the folder and its
-contents must be owned by [root]{.title-ref}. Additionally, scripts must
-only be writable by [root]{.title-ref}.
+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]{.title-ref} user. This is an
-advanced functionality with which you could break functionality or lose
-data.
+startup. Scripts will be run by the [root]{.title-ref} user.
+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: