Skip to Content
LYNKORIADocs

Status and gaps

Which deployment pieces OpenTofu and GitHub Actions automate, which steps stay manual, and what is missing or not production-ready.

Last reviewed 2026-11-16 against the repository. Launch blockers that need a live environment are tracked in blockers.

Automated (OpenTofu + GitHub Actions)

PieceWhere
VPC, both Droplets, firewalls, tagsinfra/opentofu/platform/{network,media,scanner}.tf
LiveKit, Caddy (layer4) and Redis configuration via cloud-initmedia.tf, files/livekit-*
Scanner deployment via cloud-init, private CA and certificate, renewalscanner.tf, secrets.tf
PostgreSQL cluster, database, roles, pool, trusted sources, grantsdatabases.tf, files/database-grants.sql, scripts/apply-grants.sh
Valkey with noevictiondatabases.tf
Spaces bucket, CORS, lifecycle, bucket-scoped API keystorage.tf
Every application secret (pepper, webhook master, LiveKit keys, messaging key, scanner token, origin secret)secrets.tf, zone/main.tf
App Platform app: API, migrations, owner bootstrap, metrics worker, alertsapp.tf
Cloudflare DNS, Access policy and application, Pages projects and domainsplatform/cloudflare.tf
Zone settings, origin-lock, cache and redirect rules, DMARC, CAAinfra/opentofu/zone/main.tf
Encrypted state and plans (enforced)versions.tf in both stacks
Image build, scan, push; scanner rebuilt only when its sources change.github/workflows/deploy.yml
tofu apply, smoke test (health + origin lock), Pages publishdeploy.yml
tofu plan on pull requests; zone stack apply.github/workflows/infra.yml
Offline checks: validate, mocked plan testscripts/tofu-check.sh, platform/tests/plan.tftest.hcl

Manual, once

TaskPage
Accounts, billing, Droplet limitsPrerequisites
Container registry (shared, not managed) and its planStep 1
DigitalOcean token, Spaces key, state bucket, passphrasesStep 2
Cloudflare zone, API token, Zero Trust organization and IdP (when Access is on)Step 2
GitHub environments, secrets, variables, reviewersStep 4
First-deploy DNS switch (API_DNS_PROXIED=false, then removed)Step 6
Owner's console password (interactive by design)Step 7
Monitoring backend, alert receivers, log forwarding, node_exporterStep 10
Optional Cloudflare extras: Email Routing, DNSSEC, WAF managed rules, edge rate limitingCloudflare zone

Missing or not production-ready

ItemImpact
Not yet applied to real accounts. Validated and plan-tested against mocked providers onlyThe first real apply may need fixes; check tofu plan shows no changes after a successful apply
Secret env drift on App Platform is unverifiedIf a plan after a clean apply keeps showing changes to SECRET variables, report it before relying on PR plans
State locking relies on the workflows' concurrency groups, not a lock in the bucketDo not apply locally while a workflow runs
Configuration changes replace DropletsMedia changes end active calls; scanner changes pause uploads briefly
LiveKit Egress (recording) has no deployment code (REC-01)Recording does not work until Egress runs on a separate host
One media node, no failoverA media outage stops calls; messaging keeps working
Multi-instance API supported but not load-tested (LOAD-01)Keep api_instance_count = 1 until load tests pass
Restore and rollback drills not yet run (OPS-01)Run them on staging before launch
Console CSP hard-codes the lynkoria.com API hostsAnother domain needs an edit to apps/admin/public/_headers
Bootstrap organization name is fixed to Guildsman (apps/api/src/bootstrap.ts)Rename later in the database if needed
Push notifications need product credentials; real delivery untested (PUSH-01)Leave PUSH_CREDENTIALS_JSON unset until a product provides them
Native SDK media untested on devices (NAT-01..03)Web clients are the verified path
Fidescript media isolation undecided (ADR 008)Needs a separate stack before sensitive traffic

Not deployed by design: apps/playground, apps/example-nextjs and apps/example-tanstack-start.

On this page