🏛️ Platform Architecture

Current platform shape

LayerTechnologyPurpose
FrontendSvelteKit 2 + Svelte 5 + Tailwind 4 + DaisyUI 5Web UI, game lobby, matchmaking, /play/[id] host shell
BackendNakama 3.32.0 + TypeScript runtime modulesAuth, matchmaking, leaderboards, RPCs, authoritative match state
OrchestrationK3s + AgonesPlatform services plus dedicated game-server fleet management
Edgenginx TLS → TraefikPublic HTTPS, subpath routing, WebSocket upgrade
DatabasePostgreSQL 15.6+ in postgresql namespaceReal Nakama user/game data
CacheRedis 7.2+ in funday-platform namespaceSession/cache/pub-sub support
MonitoringGrafana + PrometheusMetrics, dashboards, alerting rules
DocsQuartz 5 static wikissot.funday.gg internal operator/developer documentation
AI AgentsOmpcord/Amy + local omp toolingDiscord and CLI assisted development

Request routing

User :443


nginx (TLS termination)

  ├─ ssot.funday.gg ────────────► /home/usr/funday/ssot.funday.gg/public
  ├─ /console, /v2/console ─────► Traefik:32443 ─► nakama-console-svc:7351
  ├─ /v2, /ws ──────────────────► Traefik:32443 ─► nakama:7350
  ├─ /grafana, /prometheus ─────► Traefik:32443 ─► monitoring ingresses
  └─ /* ────────────────────────► SvelteKit:3000 via `funday-frontend.service`

Nakama deployment

SettingCurrent source-backed value
Imageheroiclabs/nakama:3.32.0
Deploymentgitops/apps/nakama-config.yaml
Namespacefunday-platform
Replicas1
Runtime path/nakama/data/modules
Runtime module sourceHost path /home/usr/funday/nakama-modules
Game mountHost path /home/usr/funday/games mounted under runtime modules
HTTP port7350
Console port7351
Metrics port9100
Readiness/liveness/healthcheck on port 7350

Secret handling

🔒 Secret values are intentionally not documented here. This wiki is served at ssot.funday.gg; keep credentials in K8s Secrets, systemd env files, or local .env files. Document names and locations only.

SettingWhere it livesBrowser exposure
Database connectionNakama deployment/config secretNever
Session / refresh encryption keysNakama configNever
Console credentials/signing keyNakama configNever
Socket server keyNakama configNever
Runtime HTTP keyServer-side env / Nakama configNever
Public Nakama host/port/SSLPUBLIC_NAKAMA_* frontend envSafe

Server identity

FieldValue
Domainfunday.gg
Wikissot.funday.gg
Server IP213.136.90.143
OSDebian 13 (trixie)

5 items under this folder.