Edge sync provisioning checklist

​

1. Register device in Golain

• Create or select project and fleet
• Add device with chosen name (e.g. gw-warehouse-07)
• Note device name — this becomes OMEGA_DEVICE_ID and MQTT client identity
• Note project topic slug (if configured) for OMEGA_ROOT_TOPIC

platform-tui context set --org=... --project=...
platform-tui devices create --name=gw-warehouse-07 --fleet=sensors --type=mqtt
platform-tui devices mqtt-details gw-warehouse-07 --fleet=sensors --output=json

​

2. Issue MQTT credentials

​

mTLS certificate (recommended production)

• Issue device certificate via cert worker / console certificates UI
• Save CA, client cert, and key to device filesystem
• Set OMEGA_TLS_*_PATH env vars

​

Username/password

• Copy MQTT username/password from device MQTT details
• Set OMEGA_MQTT_USERNAME / OMEGA_MQTT_PASSWORD

​

JITR bootstrap (ilyama)

• Obtain fleet bootstrap certificate
• Configure connection.jitr in client YAML
• On first run Omega calls JITR API → stores device cert

​

3. Configure root topic

{topic_slug}/{device_name}

• With slug: acme-prod/gw-warehouse-07
• Without slug: /gw-warehouse-07 (leading slash, no slug segment)

{root}/sync/rows/batch
{root}/sync/ingest/control   (subscribe only)

​

4. Prepare SQLite database

• Application database path known (OMEGA_SOURCE_DB_PATH)
• Tables have PRIMARY KEY defined
• Plan for post-start mutations (pre-existing rows won’t sync without snapshot)

​

5. Build and deploy Omega

• make build-client CLIENT=ilyama-edge GOOS=... GOARCH=...
• Install binary + systemd unit (deploy guide)
• Set all OMEGA_* env vars in service unit or env file
• clean_session: false in embedded connection config

​

6. Verify connectivity

• Device shows connected in console
• Heartbeat module reporting (if enabled)
• MQTT events in platform-tui:

platform-tui events list --source=mqtt --limit=20

​

7. Verify ingest

• platform-tui → Edge Sync → Lineages — one lineage per replicated table
• Segment accepted (no permanent reject loop)
• Schema review queued for new tables (expected)

​

8. Complete governance

• Claim and approve schema review
• Staged rows drain after approve
• Written view shows mirror rows (w in TUI)

​

9. Production hardening

• signed_control.enabled: true
• TLS verify-full with correct CA
• state.db on persistent volume
• Monitor lineage paused events
• Document column actions for each table schema version

​

Common misconfigurations

​

Related

• Omega setup
• Troubleshooting