v0.2.93

systemd/README.md

@@ -8,3 +8,10 @@
 6. Run `systemctl daemon-reload && systemctl enable --now rustpad`.
 
 Environment variables and an optional `.env` file override the YAML values. This allows secrets to be supplied by the service manager without editing the main configuration file.
+
+To serve attachments from a separate domain, set `files_public_url` in `rustpad.yaml`.
+The attachment-only listener uses `files_port: 3001` by default (same `app.host`).
+Point the file subdomain's reverse proxy at that port; no path-based access
+restrictions are needed. `/health` (and `/healthz`) returns `ok` on the file listener
+for health monitoring. Without `files_public_url`, files use `app.port` and
+no separate listener starts.

systemd/rustpad.yaml

@@ -9,8 +9,11 @@ database:
 
 static_dir: /opt/rustpad/static
 files_dir: /var/lib/rustpad/files
-# Optional; bare domains are normalized to HTTPS. Serve or proxy /f/* there.
+# Optional: when set, a second listener serves only /f/* attachments.
+# The separate file listener defaults to port 3001 (and shares app.host).
+# When unset, files stay on app.port and files_port is ignored.
 # files_public_url: files.note.example.org
+# files_port: 3001
 storage_driver: local
 upload_max_size_mb: 20
 guest_upload_enabled: false