Skip to main content
Check out our Resourcing Guide before getting started.

​
Guide

The Nexus 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).
1

Add the Nexus Helm repository

helm repo add Nexus https://Nexus-dot-app.github.io/Nexus/
helm repo update
helm search repo Nexus
2

Install Nexus

Install into its own namespace (recommended):
kubectl create namespace Nexus
helm install Nexus Nexus/Nexus -n Nexus
This will pull the latest Nexus chart and deploy all dependencies.
3

Verify the installation

helm list -n Nexus
kubectl get pods -n Nexus
Wait until all pods are in a Running state before accessing Nexus.
4

Access Nexus

By default, the chart exposes Nexus via a Kubernetes Service. For local testing, you can port-forward:
kubectl -n Nexus port-forward service/Nexus-nginx 8080:80
Then open http://localhost:8080.
5

Configure Nexus

Configure your deployment by modifying the values.yaml file in the Nexus/deployment/helm/charts/Nexus directory.You’ll need to restart Nexus after changing any values.yaml variables.
helm upgrade Nexus Nexus/Nexus -n Nexus -f deployment/helm/charts/Nexus/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 Nexus deployment with OAuth, OIDC, or SAML.

More Nexus Configuration Options

Learn about all available configuration options for your Nexus deployment.