Kubernetes

Check out our Resourcing Guide before getting started.

Guide

The Zortex 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 Zortex Helm repository

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

Install Zortex

Install into its own namespace (recommended):

kubectl create namespace zortex
helm install zortex zortex/zortex -n zortex

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

Verify the installation

helm list -n zortex
kubectl get pods -n zortex

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

Access Zortex

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

kubectl -n zortex port-forward service/zortex-nginx 8080:80

Then open http://localhost:8080.

Configure Zortex

Configure your deployment by modifying the values.yaml file in the zortex/deployment/helm/charts/zortex directory.You’ll need to restart Zortex after changing any values.yaml variables.

helm upgrade zortex zortex/zortex -n zortex -f deployment/helm/charts/zortex/values.yaml

See the Helm chart README for advanced options such as running as non-root and testing with Kind.

Next Steps

Configure Authentication

Set up authentication for your Zortex deployment with OAuth, OIDC, or SAML.

More Zortex Configuration Options

Learn about all available configuration options for your Zortex deployment.

Docker Terraform

Getting Started

Deploy Locally

Zortex Anywhere

Deploy on Cloud

Authentication

Miscellaneous

Guide

Next Steps

Configure Authentication

More Zortex Configuration Options

​Guide

​Next Steps

Configure Authentication

More Zortex Configuration Options

Guide

Next Steps