From 478b434858b4097e4c6de971e5d1465d43ccd690 Mon Sep 17 00:00:00 2001
From: Renon <renon@disroot.org>
Date: Thu, 24 Jan 2019 10:21:34 +0100
Subject: [PATCH] add release notes for apache config

---
 changes/notes.rst | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/changes/notes.rst b/changes/notes.rst
index 96ac3d76..8e54adf8 100644
--- a/changes/notes.rst
+++ b/changes/notes.rst
@@ -5,3 +5,38 @@ Next release notes
 
     Those release notes refer to the current development branch and are reset
     after each release.
+
+Fix Apache configuration file for 0.18 [manual action required]
+----------------------------------------------------------
+
+The way front is served has changed since 0.18. The Apache configuration can't serve 0.18 properly, leading to blank screens.
+
+If you are on an Apache setup, you will have to replace the `<Location "/api">` block with the following::
+
+   <Location "/">
+      # similar to nginx 'client_max_body_size 100M;'
+      LimitRequestBody 104857600
+
+      ProxyPass ${funkwhale-api}/
+      ProxyPassReverse ${funkwhale-api}/
+   </Location>
+
+And add some more `ProxyPass` directives so that the `Alias` part of your configuration file looks this way::
+
+   ProxyPass "/front" "!"
+   Alias /front /srv/funkwhale/front/dist
+
+   ProxyPass "/media" "!"
+   Alias /media /srv/funkwhale/data/media
+
+   ProxyPass "/staticfiles" "!"
+   Alias /staticfiles /srv/funkwhale/data/static
+
+In case you are using custom css and theming, you also need to match this block::
+
+   ProxyPass "/settings.json" "!"
+   Alias /settings.json /srv/funkwhale/custom/settings.json
+
+   ProxyPass "/custom" "!"
+   Alias /custom /srv/funkwhale/custom
+
-- 
GitLab