diff --git a/docs/advanced_usage.md b/docs/advanced_usage.md index 1d66ad918..cdc8aa719 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: