From 700eef13ed91c4e3ccb3c932e2a437ba9b174dcd Mon Sep 17 00:00:00 2001
From: Roan-V <77012724+Roan-V@users.noreply.github.com>
Date: Wed, 8 Jan 2025 14:45:47 +0100
Subject: [PATCH] Add instructions for serving FreshRSS on a subdomain with
 Caddy (#7197)

* Add instructions for serving FreshRSS on a subdomain with Caddy

* Fix failing test
---
 docs/en/admins/Caddy.md | 51 ++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 50 insertions(+), 1 deletion(-)

diff --git a/docs/en/admins/Caddy.md b/docs/en/admins/Caddy.md
index c4b4c2815..39af5ddb4 100644
--- a/docs/en/admins/Caddy.md
+++ b/docs/en/admins/Caddy.md
@@ -1,5 +1,7 @@
 ## Using Caddy as a Reverse Proxy
 
+How to configure Caddy as a reverse proxy to serve FreshRSS through a subfolder or subdomain
+
 ## Using Caddy as a Reverse Proxy with a Subfolder
 
 To set up FreshRSS behind a reverse proxy with Caddy and using a subfolder, follow these steps:
@@ -49,4 +51,51 @@ To set up FreshRSS behind a reverse proxy with Caddy and using a subfolder, foll
 
 4. **Access FreshRSS:**
 
-    FreshRSS should now be accessible at `https://example.com/freshrss`.
+    FreshRSS should now be accessible at `https://example.com/subfolder`.
+
+## Using Caddy as a Reverse Proxy with a Subdomain
+
+To set up FreshRSS behind a reverse proxy with Caddy and using a subdomain, follow these steps:
+
+1. **Configure Caddyfile:**
+
+    Update your Caddyfile with the following configuration:
+
+    ``` caddy
+	subdomain.example.com { # The url Caddy should serve the proxy on
+		reverse_proxy freshrss:80 # Enables the reverse proxy for the configured program:port
+	}
+    ```
+
+    Replace `example.com` with your actual domain and `subdomain` with the subfolder where you want FreshRSS to be hosted.
+
+    > **_NOTE:_** Ensure that the Docker container name for FreshRSS (freshrss in this example) matches the name used in the Caddyfile configuration.  
+    > **_NOTE:_** Make sure to set the DNS Records for your configured subdomain.
+
+2. **Update FreshRSS Configuration:**
+
+    Open the `config.php` file in your FreshRSS installation and update the `base_url` parameter to match the subdomain configuration:
+
+    ```php
+    'base_url' => 'https://subdomain.example.com/',
+    ```
+
+    Replace `example.com` with your actual domain and `subdomain` with the same subdomain specified in the Caddyfile.
+
+3. **Restart Caddy and FreshRSS:**
+
+    Restart Caddy to apply the configuration changes:
+
+    ```bash
+    docker compose restart caddy
+    ```
+
+    Restart FreshRSS to ensure that it recognizes the new base URL:
+
+    ```bash
+    docker compose restart freshrss
+    ```
+
+4. **Access FreshRSS:**
+
+    FreshRSS should now be accessible at `https://subdomain.example.com/`.