Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ilyama.golain.io/llms.txt

Use this file to discover all available pages before exploring further.

Omega is Golain’s edge runtime — a single binary that connects devices to the platform over MQTT (or HTTP for dev). It runs on Linux, macOS, and Windows. Repository: golain-io/omega

​
Architecture

┌──────────────────────────────────────────────────────────┐
│ Client YAML (clients/my-device.yaml)                     │
│  modules: shadow, ota, heartbeat, rpc, sqlite-repl, …   │
│  security: HMAC control, capability gating               │
└──────────────────────┬───────────────────────────────────┘
                       │
┌──────────────────────▼───────────────────────────────────┐
│ Omega runtime                                          │
│  Module lifecycle · Security · MQTT/HTTP transport      │
└──────────────────────┬───────────────────────────────────┘
                       │
┌──────────────────────▼───────────────────────────────────┐
│ Golain platform (MQTT broker + API)                      │
└──────────────────────────────────────────────────────────┘

​
Build strategies

Development — all modules, load YAML from disk: 
make build
./bin/omega-darwin-arm64 -client clients/canebot.yaml
Production — minimal client-specific binary: 
make build-client CLIENT=ilyama-edge GOOS=linux GOARCH=arm64
Client builds embed connection config and include only required modules (~7–20 MB vs ~21 MB omnibus).

​
Golain reference client

ClientPlatformUse case
ilyama-edgeLinuxJITR + SQLite replication + MQTT/QUIC
canebotLinuxRobotics data sync
railway-mitraLinuxROS2 + RTC streaming
sbfcWindowsDevice management
acme-yardLinuxTelemetry gateway
Copy clients/_template.yaml to create your own.

​
Security model

  • Control messages require HMAC-SHA256 signed envelopes
  • Each module must appear in security.capabilities
  • RPC/SSH commands restricted by security.rpc.allowed_commands
  • Payload and storage quotas enforced at runtime

​
Documentation map

Install

Binaries and cross-compile targets.

Configure

YAML profiles, modules, security.

Connect

MQTT, TLS, topic namespace.

JITR enrollment

Certificate-based registration with ilyama.

Deploy

systemd, launchd, Windows service.

Remote control

Shadow, OTA, RPC, SSH, RTC.

SQLite sync

Edge replication — lineages, schema reviews, mirror tables (full guide).