# Forgejo Runner Helm Chart

This Helm chart deploys Forgejo runners on a Kubernetes cluster.

## Installation

```bash
helm install my-forgejo-runner ./forgejo-runner-helm \
  --set forgejo.url="https://your-forgejo-instance.com" \
  --set forgejo.token="your-registration-token" \
  --set replicaCount=3
```

## Configuration

The following table lists the configurable parameters:

| Parameter | Description | Default |
|-----------|-------------|---------|
| `replicaCount` | Number of runner replicas | `1` |
| `forgejo.url` | Forgejo instance URL | `""` (required) |
| `forgejo.token` | Registration token | `""` (required) |
| `image.repository` | Container image repository | `code.forgejo.org/forgejo/runner` |
| `image.tag` | Container image tag | `latest` |
| `runner.labels` | Labels for the runner | `["ubuntu-latest"]` |
| `runner.namePrefix` | Name prefix for runners | `"forgejo-runner"` |

## Example

```yaml
# values.yaml
replicaCount: 2
forgejo:
  url: "https://forgejo.example.com"
  token: "your-secret-token"
runner:
  labels: ["ubuntu-latest", "docker"]
  namePrefix: "k8s-runner"
```# Explicit host labels test Sun Jun  8 12:56:43 AM CDT 2025