Skip to Content
LYNKORIADocs

Step 7: First sign-in

Create the owner's console password, sign in through Cloudflare Access, create a project and key, and run the control-plane smoke test.

Goal: an owner can sign in to the staging console, a first project exists, and scripts/verify-production.mjs passes.

The bootstrap-owner POST_DEPLOY job already gave OWNER_EMAIL the owner role. What is left is a password: there is no sign-up page and passwords are never put in configuration, so this one step is interactive.

7.1 Create the password account

doctl apps list --format ID,Spec.Name
doctl apps console YOUR_APP_ID api

Inside the container (it already has the database variables):

node dist/admin-users.js create --email ana@example.com --role owner
exit

It asks for the password (at least 14 characters). Use the same email as OWNER_EMAIL and as your Cloudflare Access identity. Other commands: reset-password, disable, enable, revoke-sessions, list (console access).

7.2 Sign in

  1. Open https://api-staging.lynkoria.com/v1/admin/me once. Cloudflare Access asks you to log in and sets its cookie for the API host. A JSON unauthorized reply afterwards is expected.
  2. Open https://console-staging.lynkoria.com, pass Access, sign in with the password.

7.3 Create a project, environment and key

Follow projects and API keys: create a project, add the staging environment with a LiveKit key reference from livekit_key_refs (for example example:staging), then create a key with calls:write and messaging:write. Create a second, short-lived key for the smoke test.

7.4 Control-plane smoke test

umask 077
printf 'PUBLIC_API_ORIGIN=https://api-staging.lynkoria.com\nLYNKORIA_SERVICE_KEY=%s\n' "PASTE_TEST_KEY" > verify.env
pnpm --filter @lynkoria/server... build
node --env-file=verify.env scripts/verify-production.mjs
rm verify.env

It checks anonymous denial, creates a call, mints join and messaging tokens, checks readiness and ends the call. It sends no media. Revoke the test key afterwards, then work through the production checklist for media, messaging and uploads.

Next: Step 8: Production.

On this page