Skip to content

healthchecks

Version: 1.2.0 AppVersion: 4.2.20260428

healthchecks helm package

This chart is not maintained by the upstream project and any issues with the chart should be raised here

Breaking changes

0.3.0 -> 1.0.0

The image tag was bumped from the 2021-era version-v1.20.0 to 4.1.1. This crosses the upstream Django 4.0 upgrade, which tightened CSRF_TRUSTED_ORIGINS validation (check 4_0.E001). Entries must now start with a URL scheme (https://).

If you had a healthchecks instance running on the old image, its config PVC contains a local_settings.py that was auto-generated with a scheme-less value like CSRF_TRUSTED_ORIGINS = ["hc.example.com"]. The new image will fail to start with:

SystemCheckError: System check identified some issues:
ERRORS:
?: (4_0.E001) As of Django 4.0, the values in the CSRF_TRUSTED_ORIGINS setting must start with a scheme ...

Setting the CSRF_TRUSTED_ORIGINS env var does not fix this — the linuxserver init script only writes it to local_settings.py when the key is absent, and the stale line blocks that branch. You must edit the file on the PVC directly, e.g.:

kubectl -n <ns> exec deploy/healthchecks -- sed -i \
  's|CSRF_TRUSTED_ORIGINS.*|CSRF_TRUSTED_ORIGINS = ["https://hc.example.com"]|' \
  /config/local_settings.py
kubectl -n <ns> rollout restart deploy/healthchecks

If the pod is crashlooping and exec isn't available, mount the config PVC into a one-shot busybox pod and run the same sed.

The REGENERATE_SETTINGS env var is no longer honored by the upstream image and should be removed from your values — if you previously set REGENERATE_SETTINGS: "True" to force local_settings.py regeneration, drop it. The new image manages local_settings.py unconditionally on boot (only writing keys that are absent), so the old flag has no effect.

Source Code

Requirements

Kubernetes: >=1.16.0-0

Dependencies

Repository Name Version
https://zekker6.github.io/helm-charts common 0.5.2

TL;DR

helm repo add zekker6 https://zekker6.github.io/helm-charts/
helm repo update
helm install healthchecks zekker6/healthchecks

Installing the Chart

To install the chart with the release name healthchecks

helm install healthchecks zekker6/healthchecks

Uninstalling the Chart

To uninstall the healthchecks deployment

helm uninstall healthchecks

The command removes all the Kubernetes components associated with the chart including persistent volumes and deletes the release.

Configuration

Read through the values.yaml file. It has several commented out suggested values. Other values may be used from the values.yaml from the common library.

Specify each parameter using the --set key=value[,key=value] argument to helm install.

helm install healthchecks \
  --set env.TZ="America/New York" \
    zekker6/healthchecks

Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart.

helm install healthchecks zekker6/healthchecks -f values.yaml

Custom configuration

N/A

Values

Important: When deploying an application Helm chart you can add more values from our common library chart here

Key Type Default Description
env object See below environment variables. See image docs for more details.
env.SITE_NAME string "Example Corp HealthChecks" The site's name (e.g., "Example Corp HealthChecks")
env.SITE_ROOT string "https://healthchecks.domain" The site's top-level URL and the port it listens to
env.SUPERUSER_EMAIL string "email@healthchecks.io" Superuser email
env.SUPERUSER_PASSWORD string "myVeryStrongPassword" Superuser password
env.TZ string "UTC" Set the container timezone
image.pullPolicy string "IfNotPresent" image pull policy
image.repository string "linuxserver/healthchecks" image repository
image.tag string "4.2.20260428" image tag
persistence object See values.yaml Configure persistence settings for the chart under this key.
persistence.config object {"enabled":false,"mountpath":"/config"} Volume used for configuration
service object See values.yaml Configures service settings for the chart.

Older versions

A historical overview of changes can be found on ArtifactHUB

Support


Autogenerated from chart metadata using helm-docs v1.14.2