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:
Noel Sabia committed 2026-10-15 14:44:49 +02:00
1 parent a1de7a5fae
commit f0a9d58cff
11 files changed
+37 -29

No files matched your search

+3 -4
View File
@@ -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
+8 -6
View File
@@ -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
+2 -2
View File
@@ -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