Skip to Content
LYNKORIADocs

Production checklist

Verify a deployment end to end. Automated checks first, then the manual checks no script can do.

Run after every deployment to a new environment and after infrastructure changes. The Deploy workflow already checks API readiness and the origin lock on every run; tofu plan showing no changes after a deploy confirms there is no drift. Record results, dates and who ran them in the release ticket. A green build is not a production verification.

Automated checks

CheckCommandProves
Services healthycurl -sf https://api.<domain>/health/live and /health/readyAPI up; PostgreSQL and Redis reachable from the API
Migrations appliedApp Platform deployment log shows the migrate job succeededSchema matches the image
Control planenode --env-file=/secure/verify.env scripts/verify-production.mjsService-key auth, call create/end, join and messaging tokens, readiness, anonymous denial
Scannerssh root@<scanner-ip> 'docker compose -f /opt/lynkoria-scanner/compose.yaml ps' shows scanner healthyclamd reachable, signatures fresh
Static sitescurl -sI https://console.<domain> shows Content-Security-Policy and Strict-Transport-SecuritySecurity headers deployed
MetricsQuery up{job="lynkoria-api"} and up{job="livekit"}Scraping works
CI on the deployed commitGitHub Actions run for the exact SHATests, scans and OpenAPI drift passed

verify-production.mjs needs PUBLIC_API_ORIGIN and a disposable LYNKORIA_SERVICE_KEY with calls and messaging scopes. Revoke the key afterwards. It does not publish media.

Infrastructure checks

ComponentCommandExpected
Origin lockcurl -s -o /dev/null -w '%{http_code}' https://<app>.ondigitalocean.app/openapi.json403
Cloudflare pathcurl -sI https://api.<domain>/health/ready | grep -i cf-rayA cf-ray header
Media TLScurl -sI https://rtc.<domain> and openssl s_client -connect turn.<domain>:443Valid Let's Encrypt certificates
Media DNSdig +short rtc.<domain> turn.<domain>The media IP, not Cloudflare addresses
Unknown roomcurl -s -o /dev/null -w '%{http_code}' "https://rtc.<domain>/rtc/validate?access_token=<token for a room the API did not create>"Rejected (not 200)
Database accessdoctl databases firewalls list <id> for PostgreSQL and ValkeyOnly the VPC range (no leftover runner IPs)
Runtime roleAs lynkoria_app: SHOW statement_timeout; and CREATE TABLE x(id int);30s; permission denied
BucketAnonymous curl of an object URL403
Scanner exposurecurl -m 5 -k https://<scanner-public-ip>:3344/health/ready from outside the VPCTimes out
Media firewalldoctl compute firewall get <id>Only 22 (admin IPs), 80, 443, 7881, UDP 3478, UDP 50000–60000 public

Manual end-to-end checks

Use two separate networks (for example office Wi-Fi and a phone hotspot) and two people or browser profiles. The playground can drive most of these against staging.

AreaCheck
AuthenticationConsole sign-in works; a wrong password is rejected; a disabled account cannot sign in; sign-out ends the session.
API authenticationA revoked service key fails on the next request; a lynk_test_ key is rejected by production.
WebSocketsTwo clients connect; a non-allowlisted origin is refused; a suspended user is disconnected.
Video and audioOne-to-one and group calls connect over UDP, forced TCP and forced TURN/TLS; mute, camera and device switching work; reconnect after a network change.
Screen sharingDesktop browser shares a screen and a tab; the share ends cleanly; viewers cannot share.
LivestreamingHost publishes; viewers watch and cannot publish; promoting a viewer to speaker works; the stream ends for all.
MessagingSend, edit, delete, react, read receipts and typing; disconnect, reconnect and replay history without gaps or duplicates.
PresenceStatus changes appear on another client; closing a tab marks the user offline within the lease (about 60 s).
AttachmentsA clean image uploads and downloads; EICAR is rejected; a non-member cannot download.
Recording (if Egress is deployed)A composite recording finishes, downloads through the API and is deleted after retention.
WebhooksLiveKit webhooks arrive (call usage updates); a product webhook verifies its signature and retries on failure.
ConsoleProject, environment and key changes persist and appear in the audit log; analytics show the test traffic.
SDKsA sample product backend (@lynkoria/server) and web app (@lynkoria/client) complete the quickstart against the deployment.
RecoveryRestore a database backup into an isolated cluster; roll back the API to the previous digest; an alert reaches a person.

Mobile native media, push delivery and capacity targets need devices and staging load tests; they are tracked in blockers and testing completion criteria.

On this page