alezmad/claudemesh
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
7430e4ffe0564fdc441c89c82db639b8d4aae1c6
claudemesh/docs/LAUNCH-DAY-RUNBOOK.md
Alejandro Gutiérrez 2412267fb4
Some checks failed
CI / Lint (push) Has been cancelled
Details
CI / Typecheck (push) Has been cancelled
Details
CI / Broker tests (Postgres) (push) Has been cancelled
Details
CI / Docker build (linux/amd64) (push) Has been cancelled
Details
fix(web): disable anonymous login by default (guest button removal) 
claudemesh requires an account — mesh membership is tied to user.id.
e8ad7a5 flipped the config default but the env var override at
env.config.ts:43 still defaulted to true, keeping the button visible.

Fixed at env var level + example files. Needs Coolify rebuild since
NEXT_PUBLIC_* is build-time in Next standalone.
2026-04-05 15:26:13 +01:00

2.4 KiB
Raw Blame History

claudemesh v0.1.0 — Launch Day Runbook

T-30min: Final Checks

  • dig claudemesh.com and dig ic.claudemesh.com resolve to VPS.
  • curl -I https://claudemesh.com/health and https://ic.claudemesh.com/health return 200.
  • Verify Traefik TLS cert (not expiring in 30 days).
  • npm publish --dry-run on CLI package; confirm version is 0.1.0.
  • Tail broker and web logs in Coolify.
  • Confirm pg_dump cron loaded (systemctl list-timers | grep pg_dump).
  • Silence unrelated alerts; pin on-call rotation.

T-0: Launch

  • Fire HN "Show HN: claudemesh" post.
  • Cross-post to r/LocalLLaMA, r/ClaudeAI, r/selfhosted.
  • Thread owner pins themselves for the first 6h to answer every comment.
  • Share on X/Bluesky/LinkedIn.

First 6h — Watch Window

  • Broker /metrics: claudemesh_ws_connections — alarm >500.
  • Web + broker 429 rate: if >2% of traffic, raise limits.
  • Postgres: pg_stat_activity connection count; backups run 03:00 UTC (don't interrupt).
  • Traefik logs: TLS renewal errors, 5xx spikes.
  • Signup funnel + mesh-create events every 30 min.
  • Broker memory on VPS (docker stats): escalate at >80%.

Common Failures — Responses

  • Broker OOM: bump container memory in Coolify to 2GB, redeploy. Review connection leaks after.
  • DB pool saturation: restart web container to recycle pool; if persistent, raise DATABASE_POOL_MAX to 30.
  • Rate-limits hitting legit traffic: temporarily raise web to 200 rps, broker to 80 rps via env vars; redeploy.
  • Webhook deploy backlog: cancel redundant queued deploys in Coolify; keep only the latest.
  • Signup flow broken: roll web back to previous green tag (Coolify "Redeploy previous").
  • Broker crash loop: check WSS handshake logs, disable new connections via feature flag, investigate.

Who to Page

  • Broker bugs, WSS, protocol → claudemesh peer.
  • Web UI, signup, dashboard → claudemesh-2 peer.
  • VPS, Traefik, DNS, Postgres, Coolify → ovhcloud-agutmou peer.
  • DB schema / migrations → claudemesh peer.
  • CLI / npm package → claudemesh peer.

T+24h: Post-Launch

  • Pull metrics: peak connections, signup count, mesh count, 429 rate, p95 latency.
  • Review rate-limit hits; adjust ceilings to real traffic shape.
  • Triage GitHub issues opened during launch; tag v0.2 candidates.
  • Retro with peers: biggest fire, biggest win, one fix for v0.2.
  • Schedule v0.2 planning for T+72h.
Reference in New Issue View Git Blame Copy Permalink