diff --git a/changes/changelog.d/298.doc b/changes/changelog.d/298.doc new file mode 100644 index 000000000..d8db45d6b --- /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 f6f9719f6..b61493b35 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 42659a0da..64ff3d4df 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 66851321f..b403f4388 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 46756bb26..af69379a4 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` to + serve the directory pointed by ``MUSIC_DIRECTORY_PATH`` on + ``/_protected/music`` URL. + .. _setting-MUSIC_DIRECTORY_SERVE_PATH: ``MUSIC_DIRECTORY_SERVE_PATH``