Architecture
This page gives a short orientation. You do not need more to install the platform.
Octostar runs on any conformant Kubernetes cluster. One installer
(bin/install.sh) deploys all the components. You do not deploy them one by
one.
What the platform is made of
| Layer | Contents |
|---|---|
| Core platform and AI/ML | The Octostar API, the web UI, Fusion (the knowledge layer) and the AI/ML pipeline services. Optional: Keycloak for single sign-on, a local LLM (vLLM), T3K CORE for image analysis, and the map tile server and geocoder. |
| Workflow | Temporal. |
| Data and storage | ClickHouse is the store for entities and relationships. OpenSearch is the search index. SeaweedFS is the S3-compatible object store. PostgreSQL, MySQL and Redis support the platform. |
| Observability | Prometheus, Grafana and Loki, with ready-made dashboards. |
| Cluster services | The nginx ingress controller, Traefik (routing of workspace apps), CoreDNS configuration, cert-manager for TLS, and MetalLB for bare-metal load balancing. cert-manager and MetalLB are optional. |
Where users enter
Users reach the platform at two host names on your domain:
| Host name | What it serves |
|---|---|
home.<domain> | The platform UI, the API (under /api) and the workspace apps |
fusion.<domain> | Fusion, the knowledge layer |
There is no api.<domain> host name.
You set <domain> with octostar.domain in local-env.yaml. Point these
names at the cluster in DNS. With the bundled Keycloak on its own host name,
also point auth.<domain>. See Configuration.
Online and air-gapped
- Online — the cluster pulls images and charts from the internet. You need a Docker Hub token. See Online installation.
- Air-gapped — the cluster pulls from a private registry and a chart repository that you host. See Air-gapped installation.
The platform is the same in both cases.
Next
Prerequisites, then Quick start.