Skip to content
GEO Knowledge Hub

Kubernetes installation (Helm)

The Kubernetes path is the recommended way to run the GEO Knowledge Hub in production. It uses the upstream helm-invenio chart from the InvenioRDM community, configured with the GEO Knowledge Hub settings.

This sub-section is organised into four pages:

Helm chart

Architecture of the helm-invenio chart: deployments, bundled and external services, image, and how GKH layers its configuration on top.

Quickstart (Minikube)

An end-to-end walkthrough of a working instance using Minikube.

Post-install setup

Bootstrap commands after cluster setup is complete.

Helm chart parameters reference

Searchable list of every chart parameter.

Prerequisites

Section titled “Prerequisites”
  • A Kubernetes cluster. For local testing use Minikube or kind.
  • Helm 3.
  • Kubectl.
  • An ingress controller (the chart targets nginx-ingress by default).
  • A ReadWriteMany storage class for the shared file volume.
Section titled “Recommended path”

If you have never deployed the chart before, work through the pages in this order:

1) Read the Helm chart page to understand what the chart deploys, which services are bundled, and how GEO Knowledge Hub configuration is layered on top of the upstream defaults.

2) Run the Quickstart on Minikube to confirm your tooling is set up correctly.

3) Once the initial setup is complete, check the commands required to setup the GEO Knowledge Hub services in the Post-install setup.

4) Adapt the quickstart values.yaml to your real cluster (hostname, ingress class, image tag, persistence size, replica counts), using the parameters reference as a glossary.