# Shadoll Helm Charts

A collection of custom and optimized Helm charts for self-hosted applications on Kubernetes.

## Repository Structure

- `/charts`: Individual application charts (e.g. `jellyfin`).
- `/docs`: Detailed application documentation and guides.

## Quick Start

### 1. Clone the repository
```bash
git clone https://github.com/shadoll/helm-charts.git
cd helm-charts
```

### 2. Available Charts

| Chart | Description | Status |
|-------|-------------|--------|
| [Jellyfin](docs/jellyfin.md) | Media server with PostgreSQL support | Ready |

### 3. Usage with FluxCD

To use these charts in a FluxCD environment, add the repository as a Source:

```yaml
apiVersion: source.toolkit.fluxcd.io/v1
kind: GitRepository
metadata:
  name: shadoll-charts
  namespace: flux-system
spec:
  interval: 1h
  url: https://github.com/shadoll/helm-charts
  ref:
    branch: main
```

Then reference the chart in your `HelmRelease`:

```yaml
spec:
  chart:
    spec:
      chart: ./jellyfin
      sourceRef:
        kind: GitRepository
        name: shadoll-charts
```

## Maintenance

To enable automated Signal alerts for chart updates, configure the following **GitHub Secrets** in this repository:

- `SIGNAL_URL`: The full URL to your Signal gateway (e.g. `https://signal.h.shadoll.dev/v2/send`).
- `SIGNAL_SENDER`: The phone number used to send the message.
- `SIGNAL_RECIPIENT`: The phone number(s) to receive the alert.

---
© 2026 Shadoll. Managed with ❤️ for the Home Lab.