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

# Golain documentation

> Manage fleets, devices, and edge runtimes on the Golain IoT platform.

Golain is an IoT platform for connecting, monitoring, and operating device fleets at scale. You manage organizations, projects, fleets, and devices from the **web console**, **CLI tools**, or **automation** — while **Omega** edge clients run on your hardware and sync telemetry and state back to the cloud.

## What you can do

<CardGroup cols={2}>
  <Card title="Manage fleets" icon="layer-group" href="/console/fleets-and-devices">
    Create fleets, register devices, view connectivity, tags, and MQTT credentials.
  </Card>

  <Card title="Deploy firmware" icon="rocket" href="/console/ota">
    Ship OTA releases and roll out updates to tagged fleets or individual devices.
  </Card>

  <Card title="Connect edge devices" icon="microchip" href="/edge/overview">
    Run Omega on Linux, macOS, or Windows with MQTT, JITR enrollment, and optional SQLite sync.
  </Card>

  <Card title="Automate with CLI" icon="terminal" href="/tools/platform-tui/overview">
    Install `golain` from CDN for scripting, CI, Omega deploy, and an interactive terminal UI.
  </Card>
</CardGroup>

## Platform hierarchy

Every resource in Golain lives inside a tenant hierarchy:

```
Organization  →  Project  →  Fleet  →  Device
```

* **Organization** — your company or team. Members, billing, and org-wide settings live here.
* **Project** — a logical product or environment (production, staging, a customer site).
* **Fleet** — a group of devices that share deployment context (region, firmware channel, tags).
* **Device** — a single connected unit with identity, MQTT credentials, shadow state, and telemetry.

See [Platform concepts](/getting-started/concepts) for permissions, URLs, and how the pieces fit together.

## Choose your starting point

| I want to…                        | Start here                                                                        |
| --------------------------------- | --------------------------------------------------------------------------------- |
| Explore the product in a browser  | [Quickstart](/getting-started/quickstart) → [Console overview](/console/overview) |
| Script fleet operations           | [Golain CLI](/tools/platform-tui/overview)                                        |
| SSH into a device from my laptop  | [Device SSH CLI](/tools/golain-cli/overview)                                      |
| Install software on edge hardware | [Omega edge runtime](/edge/overview)                                              |
| Run Golain on my own VM           | [Self-hosted overview](/self-hosted/overview)                                     |

## Repositories

| Component              | Repository                                              | Role                                        |
| ---------------------- | ------------------------------------------------------- | ------------------------------------------- |
| Platform API & workers | [golain-io/ilyama](https://github.com/golain-io/ilyama) | Backend services, MQTT broker, integrations |
| Web console            | [golain-io/pw](https://github.com/golain-io/pw)         | Browser UI for fleet and device management  |
| Edge client            | [golain-io/omega](https://github.com/golain-io/omega)   | On-device runtime (MQTT, OTA, shadow, RPC)  |
| Documentation          | [golain-io/docs](https://github.com/golain-io/docs)     | This site (Mintlify)                        |