Plainwire Self-Hosting2.5

Production launch checklist

Release gate#

  • [ ] exact release source/artifact recorded (2.5.0 for this handbook)
  • [ ] builder is OTP 27, 28, or 29
  • [ ] make check exits zero
  • [ ] complete EUnit suite has zero failures
  • [ ] browser and real RTC/RTP tests pass
  • [ ] staged synthetic load passes at intended capacity
  • [ ] live HTTP/WebSocket load passes at intended capacity
  • [ ] soak test shows stable memory/queues and clean recovery
  • [ ] rollback artifact and command are ready

Host#

  • [ ] Supported 64-bit Linux
  • [ ] Automatic security updates or documented patch process
  • [ ] Time synchronization working
  • [ ] File-descriptor/process limits sized for expected connections
  • [ ] Disk and inode monitoring
  • [ ] Off-host backup destination

Network#

  • [ ] DNS points to correct public address
  • [ ] 80/443 reach reverse proxy
  • [ ] backend 8080 is private
  • [ ] admin listener is private/restricted
  • [ ] PostgreSQL, Redis, Scylla ports are private
  • [ ] TURN listener/relay ports are intentional
  • [ ] IPv6 tested or AAAA record removed

Plainwire#

  • [ ] PLAINWIRE_ENV=production
  • [ ] correct PLAINWIRE_PUBLIC_URL
  • [ ] secure cookies enabled
  • [ ] encryption key backed up
  • [ ] previous encryption keys retained during rotation
  • [ ] search key backed up if independently configured
  • [ ] registration policy intentional
  • [ ] upload limits intentional
  • [ ] WebSocket, presence-watch, rate-state, and async queue limits reviewed
  • [ ] /api/health and /api/version work publicly
  • [ ] startup log shows pending migrations, including 53 on an older database, applied once
  • [ ] mail is either fully configured or explicitly left off

PostgreSQL#

  • [ ] dedicated database and role
  • [ ] supported release
  • [ ] TLS used where required
  • [ ] pool/queue/call/statement timeouts reviewed
  • [ ] backup succeeds
  • [ ] restore tested

Redis#

  • [ ] private network only
  • [ ] authentication configured
  • [ ] app password matches server password
  • [ ] worker-pool and bounded queue defaults reviewed
  • [ ] outage behavior tested

Scylla, if enabled#

  • [ ] production cluster, not development Compose
  • [ ] schema migration completed
  • [ ] backfill completed
  • [ ] outbox caught up
  • [ ] shadow/parity verification clean
  • [ ] backup/restore documented

Calls#

  • [ ] TURN configured
  • [ ] two-network call tested
  • [ ] relay-only diagnostic tested
  • [ ] screen share video and audio tested on supported browser/OS combinations
  • [ ] long call survives credential refresh
  • [ ] room-size limits match mesh client/network capacity

Bots, apps, and egress#

  • [ ] bot tokens treated as secrets
  • [ ] app/webhook egress policy reviewed
  • [ ] PLAINWIRE_APP_ALLOW_LOOPBACK_HTTP=false in production
  • [ ] interaction signatures verified by receivers
  • [ ] AI connector destinations and data recipients are intentional
  • [ ] request/response and worker concurrency limits reviewed

Security#

  • [ ] .env not in Git
  • [ ] private secrets file permissions
  • [ ] admin plane private/restricted
  • [ ] no database exposed publicly
  • [ ] logs checked for secret leakage
  • [ ] proxy trust CIDRs narrow
  • [ ] dependency/security review completed

Operations#

  • [ ] monitoring installed
  • [ ] alerts tested
  • [ ] queue/drop/eviction metrics have expected baselines
  • [ ] rollback documented
  • [ ] incident contacts documented
  • [ ] backup age monitored
Plainwire Self-Hosting Handbook · verified against Plainwire 2.5.0 · 2026-09-22