diff --git a/changes/changelog.d/298.doc b/changes/changelog.d/298.doc
new file mode 100644
index 0000000000000000000000000000000000000000..d8db45d6b3482e34c10659bba9fcccf96852df03
--- /dev/null
+++ b/changes/changelog.d/298.doc
@@ -0,0 +1 @@
+Improved documentation about in-place imports setup (#298)
diff --git a/deploy/apache.conf b/deploy/apache.conf
index f6f9719f6a3fa2c3155f6ce5b1971300a3ef8827..b61493b3520fc6975aadb2dd427e15679dd1da89 100644
--- a/deploy/apache.conf
+++ b/deploy/apache.conf
@@ -38,7 +38,7 @@ Define MUSIC_DIRECTORY_PATH /srv/funkwhale/data/music
    # lines and move the configuration to the previous server block if you
    # don't want to run funkwhale behind https (this is not recommanded)
    # have a look here for let's encrypt configuration:
-   # https://certbot.eff.org/all-instructions/#debian-9-stretch-nginx
+   # https://certbot.eff.org/lets-encrypt/debianstretch-apache.html
    SSLEngine on
    SSLProxyEngine On
    SSLCertificateFile /etc/letsencrypt/live/${funkwhale-sn}/fullchain.pem
diff --git a/deploy/env.prod.sample b/deploy/env.prod.sample
index 42659a0dabc33cf2da439b21f06f77163c544722..64ff3d4dfb7c1bdeaf7841a24c19aa668f9ad2f3 100644
--- a/deploy/env.prod.sample
+++ b/deploy/env.prod.sample
@@ -113,4 +113,4 @@ RAVEN_DSN=https://44332e9fdd3d42879c7d35bf8562c6a4:0062dc16a22b41679cd5765e5342f
 # You can safely leave those settings uncommented if you don't plan to use
 # in place imports.
 # MUSIC_DIRECTORY_PATH=
-# MUSIC_DIRECTORY_SERVE_PATH=
+# MUSIC_DIRECTORY_SERVE_PATH=  # docker-only
diff --git a/deploy/nginx.conf b/deploy/nginx.conf
index 66851321fb43017af8b893319940562309b5b604..b403f4388f9bf69399ed3479715c778fc1b837e6 100644
--- a/deploy/nginx.conf
+++ b/deploy/nginx.conf
@@ -79,18 +79,11 @@ server {
         alias /srv/funkwhale/data/media/;
     }
 
-    location /_protected/media {
-        # this is an internal location that is used to serve
-        # audio files once correct permission / authentication
-        # has been checked on API side
-        internal;
-        alias   /srv/funkwhale/data/media;
-    }
-
     location /_protected/music {
         # this is an internal location that is used to serve
         # audio files once correct permission / authentication
         # has been checked on API side
+        # Set this to the same value as your MUSIC_DIRECTORY_PATH setting
         internal;
         alias   /srv/funkwhale/data/music;
     }
diff --git a/docs/configuration.rst b/docs/configuration.rst
index 46756bb266ccf918314f57b8ef8b01dcb68409ce..af69379a4c3dd97378f52beba0eb9ca7a31232de 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -97,6 +97,12 @@ for this value. For non-docker installation, you can use any absolute path.
 
 .. note:: This path should not include any trailing slash
 
+.. warning::
+
+   You need to adapt your :ref:`reverse-proxy configuration<reverse-proxy-setup>` to
+   serve the directory pointed by ``MUSIC_DIRECTORY_PATH`` on
+   ``/_protected/music`` URL.
+
 .. _setting-MUSIC_DIRECTORY_SERVE_PATH:
 
 ``MUSIC_DIRECTORY_SERVE_PATH``