From: Ben Sturmfels <ben@sturm.com.au>
Date: Thu, 30 Apr 2020 05:11:55 +0000 (+1000)
Subject: docs: Note possible permission issues during install.
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=06d8fc891778600ad282aa92f7eb143bad8ccb55;p=mediagoblin.git

docs: Note possible permission issues during install.
---

diff --git a/docs/source/siteadmin/deploying.rst b/docs/source/siteadmin/deploying.rst
index 7b9d6e31..2e3fc992 100644
--- a/docs/source/siteadmin/deploying.rst
+++ b/docs/source/siteadmin/deploying.rst
@@ -482,6 +482,17 @@ machine in front of you, visit <http://localhost/> or if it is a
 remote server visit the URL or IP address provided to you by your
 hosting provider. You should see MediaGoblin; this time via Nginx!
 
+Try logging in and uploading an image. If after uploading you see any
+"Forbidden" errors from Nginx or your image doesn't show up, you may
+need to update the permissions on the new directories MediaGoblin has
+created::
+
+    # Debian and co.
+    sudo chown --no-dereference --recursive mediagoblin:www-data /srv/mediagoblin.example.org
+
+    # Fedora and co.
+    sudo chown --no-dereference --recursive mediagoblin:nginx /srv/mediagoblin.example.org
+
 .. note::
    
    If you see an Nginx placeholder page, you may need to remove the