-#Example configuration for when Apache httpd and Pleroma are on the same host.
-#Needed modules: define headers proxy proxy_http proxy_wstunnel rewrite ssl
-#This assumes a Debian style Apache config. Put this in /etc/apache2/sites-available
-#Install your TLS certificate, possibly using Let's Encrypt.
-#Replace 'pleroma.example.com' with your instance's domain wherever it appears
+# Sample Apache config for Pleroma
+#
+# Simple installation instructions:
+# 1. Install your TLS certificate. We recommend using Let's Encrypt via Certbot
+# 2. Replace 'example.tld' with your instance's domain.
+# 3. This assumes a Debian-style Apache config. Copy this file to
+# /etc/apache2/sites-available/ and then activate the site by running
+# 'a2ensite pleroma-apache.conf', then restart Apache.
+#
+# Optional: enable disk-based caching for the media proxy
+# For details, see https://git.pleroma.social/pleroma/pleroma/wikis/How%20to%20activate%20mediaproxy
+#
+# 1. Create a directory as shown below for the CacheRoot and make sure
+# the Apache user can write to it.
+# 2. Configure Apache's htcacheclean to clean the directory periodically.
+# Your OS may provide a service you can enable to do this automatically.