Skip to main content
Just-in-Time Registration (JITR) lets Omega enroll with Golain before the first MQTT connection. The platform returns a device certificate and broker URL; Omega stores them locally and connects with mTLS.

When to use JITR

Configuration

Enable under connection.jitr in client YAML (see clients/ilyama-edge.yaml): Environment overrides use *_env suffix fields for each value.

Flow

  1. Register device name in console or platform-tui devices create.
  2. Deploy Omega built with CLIENT=ilyama-edge (or custom YAML with JITR block).
  3. On startup Omega calls POST /core/api/v1/devices/jitr with bootstrap mTLS.
  4. Platform returns MQTT broker URL and device certificate.
  5. Omega patches connection.server_url and connects with issued cert.

Idempotency

Enrollment sends a stable Idempotency-Key derived from org_id|fleet_id|device_name. Safe to retry on network failure.

Example

Troubleshooting

Edge data sync for SQLite replication after connect