traefik-error-pages/README.md

# Traefik error pages

Maintained Helm chart serving a Cloudflare-style diagnostic page while
preserving upstream HTTP status codes. The chart owns its ConfigMap, Nginx
Deployment and Service, Traefik Errors middleware, and optional ForwardAuth
chain.

The brunner.ninja branding and Authentik integration are cluster-specific and
live in the separate
[homelab-gitops application](https://code.brunner.ninja/feedc0de/homelab-gitops/src/branch/main/apps/traefik-error-pages).
No credentials, PVCs, certificates, or public Ingress are required by this
chart. The global Traefik error-page plugin is configured separately by the
Traefik installation.

## Install elsewhere

```sh
helm repo add brunner.ninja https://brunner.ninja/charts
helm repo update brunner.ninja
helm upgrade --install traefik-error-pages brunner.ninja/traefik-error-pages \
  --namespace default --wait --timeout 5m
```

Main-branch CI validates the chart, publishes a Git-describe-derived chart
version to the public Helm repository, and promotes that exact version in
homelab-gitops. It has no Kubernetes credential. The workflow uses
`PACKAGE_USERNAME`, `PACKAGE_TOKEN`, and `GITOPS_TOKEN` repository secrets.

Run `./test.sh` for local lint/render tests. The image version is the chart's
`appVersion`. Tag the chart from that image release: `v1.30.6-alpine`
publishes chart `1.30.6-alpine`, and later chart commits append the Git
describe count and hash.