> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pangolin.net/llms.txt
> Use this file to discover all available pages before exploring further.
# Kubernetes
> How to deploy a Newt Site on Kubernetes
Fastest way to get started with Pangolin using the hosted control plane. No credit card required.
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 theme={"dark"}
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" theme={"dark"}
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" theme={"dark"}
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 theme={"dark"}
kubectl create secret generic newt-cred -n newt --from-env-file=newt-cred.env
```
Install Newt with Helm:
```bash theme={"dark"}
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 theme={"dark"}
# 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 theme={"dark"}
# 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