TIP

Check out our Resourcing Guide before getting started.

Guide

The GiiS Helm chart packages all the required services (API, web, PostgreSQL, Vespa, etc.) into a single deployment. By default, persistent volumes will be created for stateful services (e.g. PostgreSQL, Vespa).

Add the GiiS Helm repository

    helm repo add giis https://giis-ai.github.io/giis/
    helm repo update
    helm search repo giis
    ```

### Install GiiS

Install into its own namespace (recommended):

    ```bash
    kubectl create namespace giis
    helm install giis giis/giis -n giis
    ```

    This will pull the latest GiiS chart and deploy all dependencies.

### Verify the installation

```bash
    helm list -n giis
    kubectl get pods -n giis
    ```

    Wait until all pods are in a `Running` state before accessing GiiS.

### Access GiiS

By default, the chart exposes GiiS via a Kubernetes Service. For local testing, you can port-forward:

    ```bash
    kubectl -n giis port-forward service/giis-nginx 8080:80
    ```

    Then open [http://localhost:8080](http://localhost:8080).

### Configure GiiS

Configure your deployment by modifying the `values.yaml` file in the `giis/deployment/helm/charts/giis` directory.

    You'll need to restart GiiS after changing any `values.yaml` variables.

    ```bash
    helm upgrade giis giis/giis -n giis -f deployment/helm/charts/giis/values.yaml
    ```

See the [Helm chart README](https://github.com/giis-ai/giis/tree/main/deployment/helm)
for advanced options such as running as non-root and testing with Kind.