From 6abdb6e6f086a77b0b4a3b4dccce3e04794de7ad Mon Sep 17 00:00:00 2001
From: Arkonos <n.kraus@gmx.at>
Date: Sun, 8 May 2022 21:20:36 +0200
Subject: [PATCH] clarifying reverse proxying of well-known files

---
 docs/configuring-well-known.md | 18 ++++++++++++++++--
 examples/caddy2/Caddyfile      | 17 +++++++++++++++++
 2 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/docs/configuring-well-known.md b/docs/configuring-well-known.md
index 27a4001cf..9a6da547d 100644
--- a/docs/configuring-well-known.md
+++ b/docs/configuring-well-known.md
@@ -116,8 +116,22 @@ server {
 **For Caddy 2**, it would be something like this:
 
 ```caddy
-reverse_proxy /.well-known/matrix/* https://matrix.DOMAIN {
-	header_up Host {http.reverse_proxy.upstream.hostport}
+DOMAIN.com {
+   @wellknown {
+         path /.well-known/matrix/*:x
+   }
+
+   handle @wellknown {
+      reverse_proxy https://matrix.DOMAIN.com {
+          header_up Host {http.reverse_proxy.upstream.hostport}
+      }
+   }
+    # Configration for the base domain goes here
+  # handle {
+  #    header -Server
+  #     encode zstd gzip
+  #    reverse_proxy localhost:4020
+  # }
 }
 ```
 
diff --git a/examples/caddy2/Caddyfile b/examples/caddy2/Caddyfile
index 6370cb015..7d8c193db 100644
--- a/examples/caddy2/Caddyfile
+++ b/examples/caddy2/Caddyfile
@@ -214,3 +214,20 @@ element.DOMAIN.tld {
 #        }
 #  }
 #}
+DOMAIN.com {
+    @wellknown {
+        path /.well-known/matrix/*
+    }
+
+    handle @wellknown {
+        reverse_proxy https://matrix.DOMAIN.com {
+            header_up Host {http.reverse_proxy.upstream.hostport}
+        }
+    }
+    # Configration for the base domain goes here
+   # handle {
+   #    header -Server
+   #     encode zstd gzip
+   #    reverse_proxy localhost:4020
+   # }
+}