# Helm

Add the Package Firewall as a Helm chart repository, and set the chart repository it fronts.

| | |
|---|---|
| Repository URL | `https://packages.vulnes.is/helm` |
| Ecosystem ID | `helm` |
| Plan | Add-on |
| Mode | filter: `index.yaml` is filtered; `.tgz` chart downloads are checked |
| Cooldown | yes, from each chart version's `created` time |
| Default mirror | `https://evgkrsk.github.io/nxs-universal-chart` |

Helm repositories are per URL, and the firewall serves the first active `helm` mirror that answers. The seeded default is a single third-party chart repository. Set your own:

```bash
vulnetix config set package-firewall helm https://charts.example.com --priority 0
vulnetix config set package-firewall helm https://evgkrsk.github.io/nxs-universal-chart --disable
```

## Automatic setup

```bash
vulnetix package-firewall helm
```

This replaces `~/.config/helm/repositories.yaml` (existing file backed up to `.vulnetix.bak`):

```yaml
apiVersion: v1
generated: "0001-01-01T00:00:00Z"
repositories:
- name: vulnetix
  url: "https://packages.vulnes.is/helm"
  username: "YOUR_ORG_UUID"
  password: "YOUR_API_KEY"
  pass_credentials_all: true
```

> [!CAREFUL] Other repositories are removed and macOS uses another path
> The written file holds only the `vulnetix` repository; your earlier repositories are in the backup. Helm on macOS reads `~/Library/Preferences/helm/repositories.yaml`, so the CLI's file is not seen there. Use the manual command below on macOS.

## Manual equivalent

```bash
helm repo add vulnetix https://packages.vulnes.is/helm \
  --username "$VULNESIS_ORG_ID" --password "$VULNESIS_API_KEY" --pass-credentials
```

## Use and verify

```bash
helm repo update
helm search repo vulnetix
helm install demo vulnetix/<chart>
```
