variable "tls_secret_name" { type = string sensitive = true } variable "nfs_server" { type = string } resource "kubernetes_namespace" "matrix" { metadata { name = "matrix" labels = { "istio-injection" : "disabled" tier = local.tiers.aux "keel.sh/enrolled" = "true" } } lifecycle { # KYVERNO_LIFECYCLE_V1: goldilocks-vpa-auto-mode ClusterPolicy stamps this label on every namespace ignore_changes = [metadata[0].labels["goldilocks.fairwinds.com/vpa-update-mode"]] } } # Registration token from Vault KV (secret/matrix). Token-gated registration: # enabled transiently to register the admin account, then allow_registration is # flipped to false. The token stays in Vault so registration can be re-opened # later (e.g. to add family) without regenerating it. resource "kubernetes_manifest" "secrets_external_secret" { manifest = { apiVersion = "external-secrets.io/v1beta1" kind = "ExternalSecret" metadata = { name = "matrix-secrets" namespace = "matrix" } spec = { refreshInterval = "15m" secretStoreRef = { name = "vault-kv" kind = "ClusterSecretStore" } target = { name = "matrix-secrets" } dataFrom = [{ extract = { key = "matrix" } }] } } depends_on = [kubernetes_namespace.matrix] } module "tls_secret" { source = "../../modules/kubernetes/setup_tls_secret" namespace = kubernetes_namespace.matrix.metadata[0].name tls_secret_name = var.tls_secret_name } # RocksDB lives here. proxmox-lvm-encrypted (local SSD, LUKS2) suits the # homeserver DB's many small writes; NFS would be the wrong backend. resource "kubernetes_persistent_volume_claim" "data_encrypted" { wait_until_bound = false metadata { name = "matrix-data-encrypted" namespace = kubernetes_namespace.matrix.metadata[0].name annotations = { "resize.topolvm.io/threshold" = "10%" "resize.topolvm.io/increase" = "100%" "resize.topolvm.io/storage_limit" = "5Gi" } } spec { access_modes = ["ReadWriteOnce"] storage_class_name = "proxmox-lvm-encrypted" resources { requests = { storage = "1Gi" } } } lifecycle { # The autoresizer expands requests.storage up to storage_limit and # PVCs can't shrink. Without this, every TF apply tries to revert # to the spec value, K8s rejects the shrink, and the PVC ends up # in Terminating-but-in-use limbo. ignore_changes = [spec[0].resources[0].requests] } } resource "kubernetes_deployment" "matrix" { metadata { name = "matrix" namespace = kubernetes_namespace.matrix.metadata[0].name labels = { app = "matrix" tier = local.tiers.aux } } spec { replicas = 1 strategy { type = "Recreate" } selector { match_labels = { app = "matrix" } } template { metadata { labels = { app = "matrix" } annotations = { "diun.enable" = "true" "diun.include_tags" = "^v\\d+\\.\\d+\\.\\d+$" } } spec { # tuwunel runs as an unprivileged static binary; fsGroup makes the # encrypted RocksDB volume group-writable so uid 1000 can write it # (avoids the init-chown/fsGroup mismatch that parked hermes-agent). security_context { run_as_user = 1000 run_as_group = 1000 fs_group = 1000 } container { image = "ghcr.io/matrix-construct/tuwunel:v1.7.1" name = "matrix" port { container_port = 8008 } env { name = "TUWUNEL_SERVER_NAME" value = "matrix.viktorbarzin.me" } env { name = "TUWUNEL_DATABASE_PATH" value = "/var/lib/tuwunel" } env { name = "TUWUNEL_PORT" value = "8008" } env { name = "TUWUNEL_ADDRESS" value = "0.0.0.0" } env { name = "TUWUNEL_ALLOW_FEDERATION" value = "true" } env { name = "TUWUNEL_TRUSTED_SERVERS" value = jsonencode(["matrix.org"]) } # Registration OPEN (tokenless) — user-chosen 2026-06-08. tuwunel demands # this explicit flag for tokenless open registration. Bot mitigations: # the Traefik rate-limit on /register (register_ratelimit + ingress_register # below) + CrowdSec + a Loki->#security alert on every signup (monitoring # stack). To revert to token-gated: drop the YES_I_AM_VERY... flag and # re-add the TUWUNEL_REGISTRATION_TOKEN env (secret/matrix still holds it). env { name = "TUWUNEL_ALLOW_REGISTRATION" value = "true" } env { name = "TUWUNEL_YES_I_AM_VERY_VERY_SURE_I_WANT_AN_OPEN_REGISTRATION_SERVER_PRONE_TO_ABUSE" value = "true" } # 50 MiB — kept under Cloudflare's 100 MB proxied-request ceiling. env { name = "TUWUNEL_MAX_REQUEST_SIZE" value = "52428800" } # tuwunel serves its own .well-known so federation resolves to 443 # (Cloudflare-proxied) without a separate 8448 / SRV record. env { name = "TUWUNEL_WELL_KNOWN__CLIENT" value = "https://matrix.viktorbarzin.me" } env { name = "TUWUNEL_WELL_KNOWN__SERVER" value = "matrix.viktorbarzin.me:443" } # Real client IP for rate-limiting: behind Cloudflare's CF-Connecting-IP. env { name = "TUWUNEL_IP_SOURCE" value = "cf_connecting_ip" } env { name = "TUWUNEL_LOG" value = "warn,tuwunel=info" } volume_mount { name = "data" mount_path = "/var/lib/tuwunel" } resources { requests = { cpu = "100m" memory = "256Mi" } limits = { memory = "1Gi" } } } volume { name = "data" persistent_volume_claim { claim_name = kubernetes_persistent_volume_claim.data_encrypted.metadata[0].name } } } } } lifecycle { ignore_changes = [ spec[0].template[0].spec[0].dns_config, # KYVERNO_LIFECYCLE_V1 metadata[0].annotations["keel.sh/policy"], metadata[0].annotations["keel.sh/trigger"], metadata[0].annotations["keel.sh/pollSchedule"], # KYVERNO_LIFECYCLE_V2 metadata[0].annotations["keel.sh/match-tag"], spec[0].template[0].spec[0].container[0].image, # KEEL_IGNORE_IMAGE — Keel manages tag updates metadata[0].annotations["kubernetes.io/change-cause"], metadata[0].annotations["deployment.kubernetes.io/revision"], spec[0].template[0].metadata[0].annotations["keel.sh/update-time"], # KEEL_LIFECYCLE_V1 ] } } resource "kubernetes_service" "matrix" { metadata { name = "matrix" namespace = kubernetes_namespace.matrix.metadata[0].name labels = { "app" = "matrix" } } spec { selector = { app = "matrix" } port { name = "http" port = "80" target_port = "8008" } } } module "ingress" { source = "../../modules/kubernetes/ingress_factory" # Matrix homeserver — both client-server (/_matrix/client) and # server-server (/_matrix/federation) APIs use bearer tokens / signed # requests, not browser sessions. Forward-auth would break federation # and all native Matrix clients. # auth = "none": Matrix client-server + federation APIs use bearer tokens / signed requests; forward-auth incompatible with native clients. auth = "none" dns_type = "proxied" namespace = kubernetes_namespace.matrix.metadata[0].name name = "matrix" tls_secret_name = var.tls_secret_name extra_annotations = { "gethomepage.dev/enabled" = "true" "gethomepage.dev/name" = "Matrix" "gethomepage.dev/description" = "Secure messaging (tuwunel)" "gethomepage.dev/icon" = "matrix.png" "gethomepage.dev/group" = "Other" "gethomepage.dev/pod-selector" = "" } } # Open registration is bot-exposed, so rate-limit the register endpoint. Keyed on # the request HOST (a GLOBAL /register cap), NOT the source IP — this host is # reachable BOTH via Cloudflare-IPv4 (CF-Connecting-IP header) AND IPv6-direct (HE # tunnel → pfSense HAProxy → Traefik, no CF header), so a per-source-IP key would # let IPv6 bots bypass entirely. 10/min sustained, burst 20, PER Traefik replica # (×3 ≈ 30/min, burst ~60 effective). Legit signups are rare so this only bites # mass-signup; CrowdSec is the hard backstop (bans abusive IPs on both paths). A # Loki rule (stacks/monitoring) alerts #security on each successful signup. resource "kubernetes_manifest" "register_ratelimit" { manifest = { apiVersion = "traefik.io/v1alpha1" kind = "Middleware" metadata = { name = "register-ratelimit" namespace = kubernetes_namespace.matrix.metadata[0].name } spec = { rateLimit = { average = 10 period = "1m" burst = 20 sourceCriterion = { requestHost = true } } } } } # Path-scoped ingress for the register endpoints only (longer prefix → Traefik # matches it ahead of the catch-all matrix ingress) with the rate-limit middleware # attached. Same auth="none" as the main ingress (Matrix register is a UIA/bearer # API, not a browser session); anti-AI off (API endpoint, native clients). module "ingress_register" { source = "../../modules/kubernetes/ingress_factory" # auth = "none": Matrix client registration API (UIA), not a browser session. auth = "none" anti_ai_scraping = false dns_type = "none" # main module.ingress owns the DNS record for this host namespace = kubernetes_namespace.matrix.metadata[0].name name = "matrix-register" service_name = "matrix" full_host = "matrix.viktorbarzin.me" ingress_path = ["/_matrix/client/v3/register", "/_matrix/client/r0/register"] port = 80 tls_secret_name = var.tls_secret_name homepage_enabled = false # path carve-out, not its own dashboard tile extra_middlewares = ["matrix-register-ratelimit@kubernetescrd"] }