Repository navigation
feat(sensitive): Homepage as the household's entry point (#137) - #701
Merged
Merged
Conversation
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>
This was referenced Sep 29, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds Homepage at
https://home.matrix.elysiumas 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
server.statisticshomepageuserSecurity review
ports:entry.secrets/sensitive.sops.yaml, each scoped read-only. The mint steps are insecrets/sensitive.example.yaml.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 newhomepageservice and ahome.matrix.elysiumalias on Caddy.${RENDER_UID}withcap_drop: [ALL]and a read-only root./app/configand/app/.next/cache.NODE_EXTRA_CA_CERTSpoints at the tier root, so the widgets trust step-ca's certificates when they call the tier's public names through Caddy.Caddyfile: a newhome.matrix.elysiumblock.render-config.shandseed-validation-env.sh.## Homepagesection), the host-override runbook, architecture, roadmap, the root README, and a stale Dependabot comment.Verification
Measured on trinity against the pinned
v2.4.0digest with exactly the compose options:docker diffshowed nothing written outside the mounts.sensitive_sensitive, Immich and Paperless returned 401 through Caddy and the tier CA. That is the whole path except a valid token.10.0.99.20:9090.make validatepasses for this change: compose config, the healthcheck probe (wgetis in the image),caddy validateandcaddy fmt, and gitleaks. The one failure isbackup-offsite.sh --self-test. It is unrelated and happens only on this host, because/tmpon trinity is a tmpfs.Deploy (operator, after merge)
secrets/sensitive.example.yaml). The:?guards blockmake upuntil both exist.make secrets-edit STACK=sensitivehome.matrix.elysium → 10.0.99.40.make up STACK=sensitive, thenmake check-mounted-config STACK=sensitive.Refs #137
🤖 Generated with Claude Code