Skip to content

feat(sensitive): Homepage as the household's entry point (#137) - #701

Merged
Gerrrt merged 1 commit into
mainfrom
gerrrt/homepage-entry-point-e44c8d
Sep 28, 2026
Merged

Gerrrt merged 1 commit into
mainfrom
gerrrt/homepage-entry-point-e44c8d

Conversation

@Gerrrt

@Gerrrt Gerrrt commented Sep 28, 2026

Copy link
Copy Markdown
Owner

Adds Homepage at https://home.matrix.elysium as the household's page for the sensitive tier. It is a directory, not a status page: there are no status dots, and a tile shows live numbers only when a read-only API call backs them.

Tiles

Tile Kind Credential
Photos (Immich) widget API key limited to server.statistics
Documents (Paperless-ngx) widget token of a view-only homepage user
Prometheus widget, no link (9090 isn't reachable from Hicks) none (#182); same /24 as trinity
Vaultwarden, Home Assistant, AdGuard, Grafana link none. None can issue a read-only token; Grafana would also need the estate's CA on trinity

Security review

  • Default-deny isn't weakened. Hicks reaches the page through the existing 50→99 rule to trinity on 443. There is no new rule and no ports: entry.
  • Both widget tokens live in secrets/sensitive.sops.yaml, each scoped read-only. The mint steps are in secrets/sensitive.example.yaml.
  • No new device.
  • No Docker socket is mounted. It would be the full Docker API behind a page with no login.

What changed

  • stacks/sensitive/homepage/{settings,services,widgets}.yaml, mounted read-only. There is no named volume, so the backup script needs no sentinel.
  • compose.yaml: a new homepage service and a home.matrix.elysium alias on Caddy.
    • It runs as ${RENDER_UID} with cap_drop: [ALL] and a read-only root.
    • Its only writable paths are tmpfs mounts at /app/config and /app/.next/cache.
    • NODE_EXTRA_CA_CERTS points at the tier root, so the widgets trust step-ca's certificates when they call the tier's public names through Caddy.
  • Caddyfile: a new home.matrix.elysium block.
  • The two SOPS keys are added in all three places that list them: the secrets template, render-config.sh and seed-validation-env.sh.
  • Docs: the stack README (table row and a ## Homepage section), the host-override runbook, architecture, roadmap, the root README, and a stale Dependabot comment.

Verification

Measured on trinity against the pinned v2.4.0 digest with exactly the compose options:

  • Healthy, with CapEff 0.
  • docker diff showed nothing written outside the mounts.
  • 101 MiB RSS and 12 tasks.
  • A foreign Host header gets a 400.
  • With placeholder tokens, attached to sensitive_sensitive, Immich and Paperless returned 401 through Caddy and the tier CA. That is the whole path except a valid token.
  • Prometheus answered from 10.0.99.20:9090.

make validate passes for this change: compose config, the healthcheck probe (wget is in the image), caddy validate and caddy fmt, and gitleaks. The one failure is backup-offsite.sh --self-test. It is unrelated and happens only on this host, because /tmp on trinity is a tmpfs.

Deploy (operator, after merge)

  1. Mint both tokens (steps in secrets/sensitive.example.yaml). The :? guards block make up until both exist.
  2. make secrets-edit STACK=sensitive
  3. Add a host override on morpheus: home.matrix.elysium → 10.0.99.40.
  4. make up STACK=sensitive, then make check-mounted-config STACK=sensitive.
  5. From a browser on Hicks, confirm the three widgets show numbers.

Refs #137

🤖 Generated with Claude Code

Homepage at https://home.matrix.elysium lists what the tier runs and where
each service lives. It is for the people who live here, the way
docs/runbooks/successor-handover.md is for the next operator. It is a
directory, not a status page: no status dots, no siteMonitor, no ping.

Only three tiles show live numbers, each read with a credential that can
see and change nothing:
- Immich, with an API key limited to server.statistics.
- Paperless-ngx, with the token of a view-only `homepage` user.
- Prometheus, which needs no credential and is on the same /24.
Home Assistant, AdGuard, Vaultwarden and Grafana are links. None of them
can issue a read-only token, and Grafana's widget would also need the
estate's CA on trinity.

All configuration lives in stacks/sensitive/homepage/*.yaml, mounted
read-only. The service has no volume and no Docker socket. It runs as the
operator with every capability dropped and a read-only root. The only
writable paths are tmpfs mounts at /app/config and /app/.next/cache.
The two tokens come from SOPS as HOMEPAGE_VAR_*, and are added to
render-config.sh and seed-validation-env.sh. Widgets call the tier's
public names through Caddy's aliases, and NODE_EXTRA_CA_CERTS points at
the tier's root.

Measured on trinity against the pinned v2.4.0 digest, with exactly these
options:
- Healthy, with CapEff 0.
- docker diff showed nothing outside the mounts.
- 101 MiB RSS and 12 tasks.
- Hosts other than home.matrix.elysium get a 400.
- With placeholder tokens, Immich and Paperless returned 401 through
  Caddy and the tier CA.
- Prometheus answered from 10.0.99.20:9090.

Refs #137

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Gerrrt
Gerrrt merged commit 9afcd6e into main Sep 28, 2026
7 checks passed
@Gerrrt
Gerrrt deleted the gerrrt/homepage-entry-point-e44c8d branch September 28, 2026 21:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant