Skip to main content

​
What do you need to self-host Omni?

Omni relies on what we call the “Sidero Stack” which consists of the following components:
  • Container registry
  • Image Factory
  • Omni
There are also some supporting components you will need that aren’t Sidero specific such as:
  • Authentication
  • TLS certificates
  • Storage for logs and backups

​
Is Omni open source?

Omni is licensed under the Business Source License 1.1 which is not an open source license. Omni is a “source available” license which allows you to run Omni in non-production environments without a business agreement with Sidero Labs.

​
Can Omni be run air gapped?

Yes, Omni and the rest of the Sidero Stack can be run without internet access. To do so you will need to run each component within your environment. Please see documents:

​
Why do multiple Omni clusters appear as the same cluster in ArgoCD?

When using Omni-managed clusters behind the Omni kubeapi proxy, ArgoCD may treat multiple clusters as the same cluster if they share the same kubeapi server URL. This happens because ArgoCD identifies clusters primarily by their server URL, not by their cluster name or credentials. Since Omni exposes clusters through a shared kubeapi proxy endpoint, different clusters can appear identical from ArgoCD’s perspective. This is a limitation of ArgoCD and is not specific to Omni. To ensure clusters are treated separately, each cluster must have a unique server value in ArgoCD. You can do this by:
  • Appending a unique query parameter to the server URL (for example: ?cluster=cluster-a)
  • Exposing each cluster through a distinct API endpoint (via DNS, reverse proxy, or ingress)
  • Running a separate ArgoCD instance per cluster
As long as the server URL is different, ArgoCD will treat the clusters as separate clusters.