> ## 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.

# Install Omega

> Install Omega from the Golain CDN, GitHub Releases, or build from source.

## CDN install (recommended)

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

```bash theme={null}
curl -fsSL https://tools.ilyama.golain.io/omega/install.sh | sh
```

Options:

```bash theme={null}
# 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.

```bash theme={null}
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}`.

<Tip>
  **`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.
</Tip>

→ [Omega deploy with golain](/tools/platform-tui/omega-deploy)

## GitHub Releases (alternative)

Pre-built archives are also on [GitHub Releases](https://github.com/golain-io/omega/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`   |

```bash theme={null}
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+**.

```bash theme={null}
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

```bash theme={null}
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:

```bash theme={null}
make build-client CLIENT=ilyama-edge
make build-client CLIENT=canebot GOOS=linux GOARCH=arm64
```

Validate YAML without building:

```bash theme={null}
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](/edge/configure) · [Deploy with golain scaffold](/tools/platform-tui/omega-deploy)