Install on Kubernetes with OLM

Before running these steps, obtain project-granted read access to the private koios-installer repository and the images in ghcr.io/koiosplatform. These are separate permissions; see Access prerequisites. Run installer commands from an authorized checkout of the release tag described in Install.

To request access, write to the Koios project at asield03@gmail.com.

Use this when the cluster already runs OLM (tested with OLM v0.46.0). The catalog runs in the olm namespace and the cluster-scoped install in operators, where OLM provides the global OperatorGroup.

  1. Registry access (Registry access):

    common/pull-secrets.sh ghcr-auth.json operators koios olm    # cluster-scoped
    common/pull-secrets.sh ghcr-auth.json koios koios olm        # namespaced
    
  2. Catalog and operators:

    kubectl apply -k olm/kubernetes/cluster-scoped
    # or
    kubectl apply -k olm/kubernetes/namespaced
    

    Kubernetes has no global pull secret, so the CatalogSource uses koios-ghcr-pull for the catalog and the bundles. Wait for the ClusterServiceVersion to be Succeeded:

    kubectl get csv -n operators      # or -n koios for the namespaced install
    
  3. Platform. Kubernetes has no Routes: expose the platform with an Ingress (example ingress) or a Service type. Without a ReadWriteMany StorageClass, use the single-node-storage example for automation hub.

    kubectl apply -k kustomize/platform/examples/ingress
    
  4. Wait until the platform reports Successful (First login).