Plainwire Self-Hosting2.5

Command reference

Build and release#

make doctor
make build
make browsers
make check
make release

Native call health:

make build NATIVE=1
make check NATIVE=1

Load validation#

Synthetic realtime/control-plane load:

make load USERS=1000 DURATION=120 RATE=2500
make load-10000 DURATION=300 RATE=20000
make load-soak USERS=1000

Preflight a large host test:

make load-doctor USERS=10000

Live HTTP/WebSocket staging harness:

make load-live-selftest
make load-live USERS=1000 DURATION=120 RATE=0

The live harness also needs the upstream session fixture/base-URL configuration. Do not aim large live tests at an unrelated public instance.

Docker#

docker compose ps
docker compose logs --tail=200 app
docker compose up -d db redis
docker compose up -d --no-deps app

Health#

curl --fail http://127.0.0.1:8080/api/health
curl --fail https://chat.example.com/api/health
curl --fail https://chat.example.com/api/version

Scylla#

./scripts/scylla-migrate
./scripts/storage-migrate status
./scripts/storage-migrate backfill 50000
./scripts/storage-migrate verify 0 1000
./scripts/storage-migrate shadow 500
./scripts/storage-migrate parity 500
./scripts/storage-migrate reconcile-intents 500
./scripts/storage-migrate reconcile 500
./scripts/storage-migrate flush-outbox

systemd#

systemctl status plainwire
systemctl restart plainwire
journalctl -u plainwire -f

Caddy#

caddy validate --config /etc/caddy/Caddyfile
systemctl reload caddy
Plainwire Self-Hosting Handbook · verified against Plainwire 2.5.0 · 2026-09-22