docs(okf): switch reverse proxy to Caddy across bundle
own-proxy decision, terraform provisioner, system diagram, gateway SSE notes, server-budget comment and roadmap 0.4.0 now use Caddy with ACME-managed TLS instead of nginx plus certbot
This commit is contained in:
1 parent
a1de7a5fae
commit
f0a9d58cff
11 files changed
+37
-29
No files matched your search
+3
-4
@@ -1,13 +1,12 @@
|
||||
# Decisions
|
||||
|
||||
* [Learning contract with PreZero](learning-contract.md) - 2 hours of company time per week plus evenings during a 6-month learning phase; one German one-pager per finished module; the repo goes public.
|
||||
* [v1 scope](v1-scope.md) - What the first public version keeps and what moves to later phases.
|
||||
* [Accept home-server downtime in v1](accept-downtime-v1.md) - v1 serves everything from the home server; if it is down, the whole site is down.
|
||||
* [Own Caddy reverse proxy](own-proxy.md) - The apex domain points straight at the home server; a Caddy reverse proxy provisioned by Terraform is the only entry, with automatic HTTPS.
|
||||
* [Provision the server with Terraform](provision-with-terraform.md) - Packages, swap, k3s, Caddy and DNS are Terraform code; workloads inside the cluster stay with kustomize.
|
||||
* [Static Nuxt served by the gateway](static-nuxt-in-gateway.md) - Nuxt is generated to static files and embedded in the gateway image instead of running as its own pod.
|
||||
* [Own analytics tracker on SQLite](own-tracker.md) - Analytics are counted by Noel's own code in the gateway and stored as daily totals in SQLite; no third-party tracker, no Postgres.
|
||||
* [CI/CD on Gitea Actions](ci-on-gitea.md) - The existing Gitea instance and runner on the home server build, scan, deploy and version the project.
|
||||
* [Own nginx reverse proxy](own-proxy.md) - The apex domain points straight at the home server; an nginx reverse proxy installed by Terraform is the only entry.
|
||||
* [Provision the server with Terraform](provision-with-terraform.md) - Packages, swap, k3s, nginx and DNS are Terraform code; workloads inside the cluster stay with kustomize.
|
||||
* [Own nginx reverse proxy](own-proxy.md) - The apex domain points straight at the home server; an nginx reverse proxy installed by Terraform is the only entry.
|
||||
* [Knowledge bundle lives at the repository root](bundle-at-root.md) - The repository root is the OKF bundle root; any other markdown file there needs frontmatter to stay conformant.
|
||||
|
||||
# Open
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
---
|
||||
type: Decision
|
||||
title: Own nginx reverse proxy instead of Cloudflare Tunnel
|
||||
description: The apex domain points straight at the home server; an nginx reverse proxy installed by Terraform is the only entry.
|
||||
tags: [decision, networking, nginx, terraform]
|
||||
title: Own Caddy reverse proxy instead of Cloudflare Tunnel
|
||||
description: The apex domain points straight at the home server; a Caddy reverse proxy installed by Terraform is the only entry.
|
||||
tags: [decision, networking, caddy, terraform]
|
||||
status: stable
|
||||
generated: { by: claude-code/claude-opus-5-5, at: 2026-10-14T00:00:00Z }
|
||||
verified: { by: human:noel, at: 2026-10-14T00:00:00Z }
|
||||
@@ -11,15 +11,17 @@ verified: { by: human:noel, at: 2026-10-14T00:00:00Z }
|
||||
# Decision
|
||||
|
||||
No tunnel, no managed entry service. A DNS A record points the apex domain at
|
||||
the home server directly; nginx (installed and configured by Terraform, with a
|
||||
certbot certificate) terminates TLS and forwards to the gateway Service.
|
||||
the home server directly; Caddy (provisioned by Terraform) terminates HTTPS,
|
||||
gets and renews certificates via its ACME client, and forwards to the gateway
|
||||
Service.
|
||||
|
||||
# Why
|
||||
|
||||
- A managed tunnel outsources exactly the part Noel wants to learn: DNS, TLS,
|
||||
proxies and what happens between a browser and a container.
|
||||
- No dependency on a third party. The entry path is Noel's own code and config.
|
||||
- nginx on the same 4 GB server costs a few MB, well inside the budget.
|
||||
- Caddy on the same 4 GB server costs a few MB, well inside the budget.
|
||||
- Automatic HTTPS needs no certbot; the Caddyfile is about five lines.
|
||||
|
||||
# Consequences
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
type: Decision
|
||||
title: Provision the server with Terraform
|
||||
description: Packages, swap, k3s, nginx and DNS are Terraform code; workloads inside the cluster stay with kustomize.
|
||||
description: Packages, swap, k3s, Caddy and DNS are Terraform code; workloads inside the cluster stay with kustomize.
|
||||
tags: [decision, terraform, infra]
|
||||
status: stable
|
||||
generated: { by: claude-code/claude-opus-5-5, at: 2026-10-14T00:00:00Z }
|
||||
@@ -11,7 +11,7 @@ verified: { by: human:noel, at: 2026-10-14T00:00:00Z }
|
||||
# Decision
|
||||
|
||||
Terraform owns everything outside k3s: server packages, swap, the k3s
|
||||
install, nginx and certbot, and the DNS record. Nothing inside the cluster.
|
||||
install, Caddy (including automatic HTTPS) and the DNS record. Nothing inside the cluster.
|
||||
|
||||
# Why
|
||||
|
||||
|
||||
Reference in new issue
Block a user