From 4954a5dd36339d661f5a4f3a9768d3fc348f631b Mon Sep 17 00:00:00 2001
From: Ezra <ezra@hermes.local>
Date: Sun, 5 Apr 2026 07:40:21 +0000
Subject: [PATCH] =?UTF-8?q?[COMM]=20Matrix/Conduit=20deployment=20scaffold?=
 =?UTF-8?q?=20=E2=80=94=20closes=20#183,=20supports=20#166?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 scaffold/matrix-conduit/nginx-matrix.conf | 64 +++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 scaffold/matrix-conduit/nginx-matrix.conf

diff --git a/scaffold/matrix-conduit/nginx-matrix.conf b/scaffold/matrix-conduit/nginx-matrix.conf
new file mode 100644
index 00000000..6faa0f6f
--- /dev/null
+++ b/scaffold/matrix-conduit/nginx-matrix.conf
@@ -0,0 +1,64 @@
+# Nginx Reverse Proxy for Matrix/Conduit
+# Place in /etc/nginx/sites-available/matrix and symlink to sites-enabled
+
+# HTTP → HTTPS redirect
+server {
+    listen 80;
+    server_name matrix.fleet.tld;
+    return 301 https://$server_name$request_uri;
+}
+
+# Main HTTPS server (client traffic)
+server {
+    listen 443 ssl http2;
+    server_name matrix.fleet.tld;
+
+    ssl_certificate /etc/letsencrypt/live/matrix.fleet.tld/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/matrix.fleet.tld/privkey.pem;
+
+    # Security headers
+    add_header X-Frame-Options "SAMEORIGIN" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header X-XSS-Protection "1; mode=block" always;
+
+    # Matrix client-server API
+    location /_matrix {
+        proxy_pass http://127.0.0.1:6167;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+
+        # WebSocket support (for sync)
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+
+        # Timeouts for long-polling
+        proxy_read_timeout 600s;
+    }
+
+    # Element web client (if self-hosting)
+    location / {
+        proxy_pass http://127.0.0.1:8080;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+# Federation server (port 8448)
+server {
+    listen 8448 ssl http2;
+    server_name matrix.fleet.tld;
+
+    ssl_certificate /etc/letsencrypt/live/matrix.fleet.tld/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/matrix.fleet.tld/privkey.pem;
+
+    location / {
+        proxy_pass http://127.0.0.1:6167;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+}