---
title: "Kubernetes"
description: "How to deploy a Newt Site on Kubernetes"
---
This guide walks you through setting up Newt on Kubernetes using Helm.
This guide assumes you already are familiar with Kubernetes concepts and you fulfill the following Global prerequisites:
## Global Prerequisites
- Kubernetes Cluster (v1.28.15+)
- Access to the Kubernetes Cluster
- Helm (v3.0+) installed, see Helm install docs
## Helm Installation
All Fossorial Helm charts are available on Artifact Hub. See Fossorial Charts.
```bash
helm repo add fossorial https://charts.fossorial.io
helm repo update fossorial
helm search repo fossorial
```
Prepare your Newt credentials:
```env title="newt-cred.env"
PANGOLIN_ENDPOINT=
NEWT_ID=
NEWT_SECRET=
```
Prepare a values file with your desired configuration.
See Newt chart values configuration options.
```yaml title="values-newt.yaml"
newtInstances:
- name: main
enabled: true
auth:
existingSecretName: newt-cred
keys:
endpointKey: PANGOLIN_ENDPOINT
idKey: NEWT_ID
secretKey: NEWT_SECRET
```
Create a Kubernetes Secret from the env file created earlier:
```bash
kubectl create secret generic newt-cred -n newt --from-env-file=newt-cred.env
```
Install Newt with Helm:
```bash
helm install my-newt fossorial/newt \
-n newt --create-namespace \
-f values-newt.yaml
```
Change the release name (`my-newt`), namespace (`newt`), and values filename as needed.
```bash
# Update repo to get latest charts
helm repo update fossorial
# Upgrade Newt (after editing values)
helm upgrade my-newt fossorial/newt -n newt -f values-newt.yaml
```
```bash
# Roll back to a previous revision
helm rollback my-newt 1 -n newt
```
## Customizing Your Values
All configuration options are documented in the respective repositories:
- Newt Helm chart values
## References
- All Fossorial Helm Charts repo
- All Fossorial Kubernetes resources
- Pangolin Kubernetes Controller
- Helm documentation