mirror/FreshRSS
0
0
Fork 0
mirror of https://github.com/FreshRSS/FreshRSS.git synced 2026-01-29 07:31:06 -05:00
Code Issues Packages Projects Releases Wiki Activity

Add instructions for serving FreshRSS on a subdomain with Caddy (#7197)

Browse Source 
* Add instructions for serving FreshRSS on a subdomain with Caddy

* Fix failing test
This commit is contained in:
Roan-V
2025-01-08 14:45:47 +01:00
committed by GitHub
parent ca42b0b8cc
commit 700eef13ed
1 changed files with 50 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

51
docs/en/admins/Caddy.md
View File

@@ -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/`.