diff --git a/plan/decisions.md b/plan/decisions.md index 982c35d..037d98f 100644 --- a/plan/decisions.md +++ b/plan/decisions.md @@ -144,6 +144,6 @@ Tokens are minted with `slinuxm token create `, printed once, and never st **Status:** Proposed -Bearer tokens over plain HTTP are readable on the wire, and LAN exposure is the intended deployment. The service gets native TLS: `server.tls.enabled`, `cert_file`, `key_file`, with certificate reload on SIGHUP so ACME or sops-managed rotation needs no restart. A reverse proxy still works and nothing depends on it. rustls is already in the dependency tree and openssl stays out. When TLS is enabled the MCP Origin allowlist uses `https://`. A non-loopback bind without TLS logs a startup warning but is not refused. +Bearer tokens over plain HTTP are readable on the wire, and LAN exposure is the intended deployment. The service gets native TLS: `server.tls.enabled`, `cert_file`, `key_file`, with certificate reload on SIGHUP so ACME or sops-managed rotation needs no restart. A reverse proxy still works and nothing depends on it. rustls is already in the dependency tree and openssl stays out. When TLS is enabled the MCP Origin allowlist uses `https://`. TLS is optional and off by default; with it off nothing changes. A non-loopback bind without TLS logs a startup warning but is not refused. **Decision:** diff --git a/plan/workstreams/WS-I-tls.md b/plan/workstreams/WS-I-tls.md index be0ef8f..5f4ccc2 100644 --- a/plan/workstreams/WS-I-tls.md +++ b/plan/workstreams/WS-I-tls.md @@ -34,6 +34,7 @@ Tick these in [`TODO.md`](../../TODO.md). ## Notes +- **TLS is optional (user requirement, 2026-10-16).** `server.tls.enabled` defaults to `false`. With it off the server behaves exactly as before: plain HTTP, no cert or key files read, MCP origins stay `http://`. It is configurable by file, env (`SKYG_SERVER__TLS__*`) and shown by `--print-config`. Existing tests pass unchanged with the default config. - DEC-12 holds the rationale. The NixOS module (WS-H) passes certificate paths through systemd `LoadCredential` so the service user never needs read access to the original key file. ## Log