Install Omega

CDN install (recommended)

Omega is published at https://tools.ilyama.golain.io/omega/ with the same channel layout as golain (stable, latest, dev).

curl -fsSL https://tools.ilyama.golain.io/omega/install.sh | sh

Options:

# Channel or pinned version
curl -fsSL https://tools.ilyama.golain.io/omega/install.sh | sh -s -- --channel=dev
curl -fsSL https://tools.ilyama.golain.io/omega/install.sh | sh -s -- --version=0.1.2b --prefix=$HOME/.local/bin

# Verify
omega -version

Flag / env	Purpose
`--channel=stable\|latest\|dev`	Release channel (`OMEGA_CHANNEL`)
`--version=VERSION`	Pin version (`OMEGA_VERSION`)
`--prefix=DIR`	Install directory (default `$HOME/.local/bin`)
`OMEGA_BASE_URL`	CDN root (default `https://tools.ilyama.golain.io/omega`)

Manifests: https://tools.ilyama.golain.io/omega/manifest/{stable,latest,dev}.json Supported platforms via CDN: Linux and macOS (amd64, arm64).

SQLite extensions and omega-db

SQLite replication needs loadable JSON and timeseries extensions plus the omega-db helper for trigger setup and mutations.

curl -fsSL https://tools.ilyama.golain.io/omega/install-sqlite-deps.sh | sh

Default install locations:

Component	Default path
`omega-db`	`$HOME/.local/bin/omega-db`
Extensions	`$HOME/.local/lib/golain/sqlite-ext/`

Options: --channel, --version, --prefix, --ext-dir, --arch=GOOS_GOARCH. Manifest asset keys: sqlite_deps_{darwin,linux}_{amd64,arm64}.

golain omega scaffold and the TUI Deploy Omega wizard download Omega and SQLite deps automatically into the deployment output directory. Use the standalone installers when you only need Omega or deps without scaffolding.

→ Omega deploy with golain

GitHub Releases (alternative)

Pre-built archives are also on GitHub Releases:

Platform	Architecture	Archive
Linux	x86_64	`omega_vX.Y.Z_linux_amd64.tar.gz`
Linux	ARM64	`omega_vX.Y.Z_linux_arm64.tar.gz`
macOS	Intel	`omega_vX.Y.Z_darwin_amd64.tar.gz`
macOS	Apple Silicon	`omega_vX.Y.Z_darwin_arm64.tar.gz`
Windows	x86_64	`omega_vX.Y.Z_windows_amd64.zip`

curl -L https://github.com/golain-io/omega/releases/latest/download/omega_linux_amd64.tar.gz | tar xz
sudo mv omega /usr/local/bin/
omega -version

Windows: download the .zip, extract, add to PATH, run omega -version.

Build from source

Requires Go 1.25+.

git clone https://github.com/golain-io/omega
cd omega
make build
./bin/omega-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/') -version

Cross-compile

make build GOOS=linux GOARCH=arm64
make build GOOS=windows GOARCH=amd64
make build-all    # all five platform/arch pairs

Client-specific build

Production binaries embed connection config and only required modules:

make build-client CLIENT=ilyama-edge
make build-client CLIENT=canebot GOOS=linux GOARCH=arm64

Validate YAML without building:

make codegen CLIENT=my-device

Release bundle contents

omega
profiles/           # generic test profiles
clients/
  _template.yaml    # starting point for custom configs

Next steps

→ Configure your client YAML · Deploy with golain scaffold

Omega edge runtime

Device RPC

Edge SQLite sync

Edge agent (Omega)

Operate & query

Wire protocol reference

CDN install (recommended)

SQLite extensions and omega-db

GitHub Releases (alternative)

Build from source

Cross-compile

Client-specific build

Release bundle contents

Next steps

​CDN install (recommended)

​SQLite extensions and omega-db

​GitHub Releases (alternative)

​Build from source

​Cross-compile

​Client-specific build

​Release bundle contents

​Next steps

CDN install (recommended)

SQLite extensions and omega-db

GitHub Releases (alternative)

Build from source

Cross-compile

Client-specific build

Release bundle contents

Next steps