Skip to content

Commit 9383ddb

Browse files
authored
Refine reverse proxy guidance for deployment docs (#968)
1 parent 9942762 commit 9383ddb

File tree

1 file changed

+10
-22
lines changed

1 file changed

+10
-22
lines changed

src/content/docs/web-application/how-to/deployment.mdx

Lines changed: 10 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -29,33 +29,19 @@ When hosting a **public instance** that others will use, please follow these ess
2929

3030
### Modern Reverse Proxy Options
3131

32-
- **Caddy** — Automatic HTTPS, zero config
33-
- **Traefik**Auto-discovery, perfect for Docker
34-
- **nginx**Traditional, requires certbot setup
32+
- **Caddy (recommended default)** — Automatic HTTPS with smart defaults for standalone hosts. Read the [official getting started guide](https://caddyserver.com/docs/getting-started) and Docker image notes on the [Caddy Hub page](https://hub.docker.com/_/caddy).
33+
- **Traefik (container-aware automation)**Ideal when you need dynamic routing, Let's Encrypt, and tight Docker or orchestrator integration. Start with the [Traefik quick start](https://doc.traefik.io/traefik/getting-started/quick-start/) and [Docker provider docs](https://doc.traefik.io/traefik/providers/docker/).
34+
- **nginx (advanced alternative)**Manual control for complex edge setups or legacy migrations. Follow the official [reverse proxy configuration guide](https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/) or the [nginx Docker image reference](https://hub.docker.com/_/nginx) when building custom stacks.
3535

3636
### HTTPS
3737

38-
For most deployments we recommend **Caddy** as the default reverse proxy. Its
39-
[Automatic HTTPS](https://caddyserver.com/docs/automatic-https) feature handles
40-
certificate issuance, renewal, and HTTP→HTTPS redirects with almost zero
41-
configuration, making it ideal for quickly hardening html2rss-web instances.
42-
43-
If you need tighter integration with container orchestration, **Traefik** is an
44-
excellent alternative. Follow the official
45-
[Traefik ACME guide](https://doc.traefik.io/traefik/https/acme/) to enable
46-
automatic certificates using Let's Encrypt while keeping dynamic routing and
47-
Docker auto-discovery.
48-
49-
> **Other options:** Prefer nginx, Cloudflare, or another edge provider? Stick to
50-
> their upstream tutorials such as the
51-
> [nginx TLS termination guide](https://docs.nginx.com/nginx/admin-guide/security-controls/terminating-ssl-http/)
52-
> and [Cloudflare SSL/TLS docs](https://developers.cloudflare.com/ssl/). These
53-
> tools offer robust HTTPS setups when configured per their official
54-
> documentation.
38+
Each of the proxies above can terminate TLS for html2rss-web. Lean on their official guidance for enabling automatic certificates, renewing them, and forcing HTTPS redirects so your instance stays secure without bespoke tweaks.
5539

5640
## Quick Docker Setup
5741

58-
### Caddy (Easiest)
42+
### Recommended: Caddy reverse proxy
43+
44+
Pair this Compose stack with the [official Caddy Docker instructions](https://hub.docker.com/_/caddy) when you need an instant HTTPS front end.
5945

6046
```yaml
6147
services:
@@ -84,7 +70,9 @@ yourdomain.com {
8470
}
8571
```
8672

87-
### Traefik (Auto-discovery)
73+
### Advanced automation: Traefik with Docker labels
74+
75+
This variant matches the [Traefik Docker provider examples](https://doc.traefik.io/traefik/providers/docker/#docker-compose).
8876

8977
```yaml
9078
services:

0 commit comments

Comments
 (0)