meldestelle/docs/01_Architecture/Pangolin/Mange_Pangolin/Sites/Kubernetes.md
Stefan Mogeritsch aa157e82f8 docs: add new Access Control and Logs documentation pages
- Documented Access Control features (e.g., Device Approvals, Password Rotation, 2FA, Custom Login Pages).
- Added detailed descriptions for Logs & Analytics (Access Logs, Request Logs, Action Logs).
- Included configuration instructions and feature-specific notes for Pangolin Cloud and Enterprise Edition.

Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
2026-03-11 11:24:24 +01:00

3.4 KiB

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={null} 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={null}
PANGOLIN_ENDPOINT=<your-endpoint>
NEWT_ID=<your-id>
NEWT_SECRET=<your-secret>
```

Prepare a values file with your desired configuration.

<Tip>See <Link href="https://github.com/fosrl/helm-charts/tree/main/charts/newt">Newt chart values configuration options</Link>.</Tip>

```yaml title="values-newt.yaml" theme={null}
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={null}
kubectl create secret generic newt-cred -n newt --from-env-file=newt-cred.env
```

Install Newt with Helm:

```bash  theme={null}
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={null} # 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={null}
# 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