Default port is now 1984 everywhere

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YShymaPrXmc3KYRUg2HMSs
This commit is contained in:
ariandClaude Sonnet 5.5 committed 2026-10-16 11:18:47 -04:00
1 parent dbe8a8d4e0
commit bdccace271
9 files changed
+35 -35

No files matched your search

+2 -2
View File
@@ -108,11 +108,11 @@ The MCP spec requires Origin validation on Streamable HTTP servers. If the pinne
---
## DEC-9 — Port 1984 in the NixOS module, loopback by default
## DEC-9 — Port 1984 by default, loopback by default
**Status:** Decided 2026-10-16
The module defaults `port = 1984` and `bind = "127.0.0.1"`. The binary's own default is unchanged. Exposing the service to the LAN is an install-time choice made in the host's own config, never a default: the operator sets `bind`, `openFirewall` (or an interface-scoped rule) and `allowedHosts` for that deployment. Config validation already refuses auth-off on a non-loopback bind, and a non-loopback bind without TLS logs a warning (see DEC-12).
The binary and the NixOS module both default to `port = 1984` and `bind = "127.0.0.1"` (the binary default was 9109 until 2026-10-16, when the user made 1984 the default everywhere). Exposing the service to the LAN is an install-time choice made in the host's own config, never a default: the operator sets `bind`, `openFirewall` (or an interface-scoped rule) and `allowedHosts` for that deployment. Config validation already refuses auth-off on a non-loopback bind, and a non-loopback bind without TLS logs a warning (see DEC-12).
**Decision:** Accepted by the user. The default is loopback. Installs change the relevant settings.
+1 -1
View File
@@ -48,7 +48,7 @@ Tick these in [`TODO.md`](../../TODO.md).
## Done when
- F9 passes.
- With P3 wiring, Verification #4 passes. MCP Inspector at `http://localhost:9109/mcp` with a bearer header lists 8 tools, 2 prompts and 2 resources, and every tool returns data. Without the header the client receives 401.
- With P3 wiring, Verification #4 passes. MCP Inspector at `http://localhost:1984/mcp` with a bearer header lists 8 tools, 2 prompts and 2 resources, and every tool returns data. Without the header the client receives 401.
## Notes
+2 -2
View File
@@ -21,7 +21,7 @@ Tick these in [`TODO.md`](../../TODO.md).
- **H2** `flake.nix` exporting `packages.<system>.default` and `nixosModules.default`, plus `checks` wired to H8.
- **H3** `nix/module.nix` options under `services.skyg-linux-tracker`:
- `enable`, `package`
- `port` (default **1984**; the app default is unchanged, DEC-9)
- `port` (default **1984**, same as the binary default)
- `bind` (default `"127.0.0.1"`; LAN exposure is set per install)
- `tls.enable`, `tls.certFile`, `tls.keyFile` (passed via systemd `LoadCredential`, DEC-12)
- `openFirewall` (default `false`)
@@ -54,7 +54,7 @@ Tick these in [`TODO.md`](../../TODO.md).
## Notes
- Port 1984 is set in the module only, so the non-Nix path is unchanged.
- Port 1984 is also the binary default, so the module just passes it through.
- Tokens are printed once and never stored (DEC-11). Declarative/hash-imported tokens and activation-time `bootstrapTokens` are out of scope for v1 are not offered.
- The module must not put secrets in the generated TOML. Anything sensitive goes through `environmentFile`.