Skip to content

Healthchecks

Logo

Description

Healthchecks is a watchdog for your cron jobs. It's a web server that listens for pings from your cron jobs, plus a web interface.

Image

linuxserver/healthchecks:latest

Categories

  • Taskserver

Ports

  • 8000:8000/tcp

Volumes

ContainerBind
/config/opt/appdata/healthchecks

Environment Variables

NameLabelDefaultDescription
PUIDPUID1024for GroupID
PGIDPGID100for UserID
SITE_ROOTSITE_ROOT<SITE_ROOT>The site's top-level URL and the port it listens to if differrent than 80 or 443 (e.g., https://healthchecks.example.com:8000)
SITE_NAMESITE_NAME<SITE_NAME>The site's name (e.g., 'Example Corp HealthChecks')
DEFAULT_FROM_EMAILDEFAULT_FROM_EMAIL<DEFAULT_FROM_EMAIL>From email for alerts
EMAIL_HOSTEMAIL_HOST<EMAIL_HOST>SMTP host
EMAIL_PORTEMAIL_PORT<EMAIL_PORT>SMTP port
EMAIL_HOST_USEREMAIL_HOST_USER<EMAIL_HOST_USER>SMTP user
EMAIL_HOST_PASSWORDEMAIL_HOST_PASSWORD<EMAIL_HOST_PASSWORD>SMTP password
EMAIL_USE_TLSEMAIL_USE_TLS<True or False>Use TLS for SMTP (`True` or `False`)
ALLOWED_HOSTSALLOWED_HOSTS<ALLOWED_HOSTS>array of valid hostnames for the server `['test.com','test2.com']` (default: `['*']`)
SUPERUSER_EMAILSUPERUSER_EMAIL<SUPERUSER_EMAIL>Superuser email
SUPERUSER_PASSWORDSUPERUSER_PASSWORD<SUPERUSER_PASSWORD>Superuser password
REGENERATE_SETTINGSREGENERATE_SETTINGSTrue/FalseDefaults to False. Set to true to always override the `local_settings.py` file with values from environment variables. Do not set to True if you have made manual modifications to this file.
SITE_LOGO_URLSITE_LOGO_URL<SITE_LOGO_URL>Custom site logo URL
SECRET_KEYSECRET_KEY<SECRET_KEY>A secret key used for cryptographic signing. docker-healthchecks will generate a secure value if one does not exist
APPRISE_ENABLEDAPPRISE_ENABLEDTrue/FalseDefaults to False. A boolean that turns on/off the Apprise integration (https://github.com/caronc/apprise)

Labels

KeyValue
traefik.enabletrue
traefik.http.routers.healthchecks.ruleHost(`healthchecks.{$TRAEFIK_INGRESS_DOMAIN}`)
traefik.http.routers.healthchecks.entrypointshttps
traefik.http.services.healthchecks.loadbalancer.server.port8000
traefik.http.routers.healthchecks.tlstrue
traefik.http.routers.healthchecks.tls.certresolverdefault
traefik.http.routers.healthchecks.middlewarestraefik-forward-auth
mafl.enabletrue
mafl.titleHealthchecks
mafl.descriptionHealthchecks is a watchdog for your cron jobs.
mafl.linkhttps://healthchecks.{$TRAEFIK_INGRESS_DOMAIN}
mafl.icon.wraptrue
mafl.icon.color#007acc
mafl.status.enabledtrue
mafl.status.interval60
mafl.groupTaskserver
mafl.icon.urlhttps://raw.githubusercontent.com/healthchecks/healthchecks/master/static/img/up.png

Licensed under the MIT License. Free for all use cases. For enterprise or academic support, please reach out to us.