healthchecks

healthchecks

Docker app from linuxserver's Repository

Overview

Healthchecks(https://github.com/healthchecks/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.

Runtime arguments

Web UI
http://[IP]:[PORT:8000]
Network
bridge
Shell
bash
Privileged
false

Template configuration

WebUIPorttcp

Healthchecks Web UI

Target
8000
Default
8000
Port: 2525Porttcp

Port for inbound SMTP pings

Target
2525
Default
2525
AppdataPathrw

Persistent config files.

Target
/config
SECRET_KEYVariable

A secret key used for cryptographic signing. Will generate a random value if one is not supplied and save it to `/config/local_settings.py`.

SITE_ROOTVariable

The site's top-level URL and the port it listens to if different than 80 or 443 (e.g., https://healthchecks.example.com:8000).

SITE_NAMEVariable

The site's name (e.g., "Example Corp HealthChecks").

SUPERUSER_EMAILVariable

Superuser email.

SUPERUSER_PASSWORDVariable

Superuser password.

ALLOWED_HOSTSVariable

A comma-separated list of valid hostnames for the server. Default is the domain portion of `SITE_ROOT`.

APPRISE_ENABLEDVariable

Set to `True` to enable the Apprise integration (https://github.com/caronc/apprise).

Default
False
CSRF_TRUSTED_ORIGINSVariable

A list(https://docs.python.org/3/tutorial/introduction.html#lists) of trusted origins for unsafe requests (e.g. POST). Defaults to the value of `SITE_ROOT`.

DEBUGVariable

Set to `False` to disable. Debug mode relaxes CSRF protections and increases logging verbosity but should be disabled for production instances as it will impact performance and security.

Default
True
DEFAULT_FROM_EMAILVariable

From email for alerts.

EMAIL_HOSTVariable

SMTP host.

EMAIL_PORTVariable

SMTP port.

EMAIL_HOST_USERVariable

SMTP user.

EMAIL_HOST_PASSWORDVariable

SMTP password.

EMAIL_USE_TLSVariable

Use TLS for SMTP (`True` or `False`).

INTEGRATIONS_ALLOW_PRIVATE_IPSVariable

Defaults to False. Set to True to allow integrations to connect to private IP addresses.

PING_EMAIL_DOMAINVariable

The domain to use for generating ping email addresses. Defaults to `localhost`.

RP_IDVariable

If using webauthn for 2FA set this to match your Healthchecks domain. Webauthn will only work over https.

SITE_LOGO_URLVariable

Full URL to custom site logo.

PUIDVariable

Container Variable: PUID

Default
99
PGIDVariable

Container Variable: PGID

Default
100
UMASKVariable

Container Variable: UMASK

Default
022

Download Statistics

18,444,129
Total Downloads
26,614
This Month
27,975
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
lscr.io/linuxserver/healthchecks
Last Updated2026-05-04
First Seen2021-10-23

Run Healthchecks on Unraid.

Healthchecks is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.