MirrorNest
← All guides

Healthchecks

Healthchecks is a cron job and scheduled task monitoring service that alerts you when a periodic task fails to check in on time, officially self-hostable via a documented Docker Compose setup.

Target: Any Docker hostMonitoringOfficial homepage ↗Official docs ↗
This guide is synthesized from Healthchecks's own official documentation, linked above — always cross-check exact package/version names there before running these commands on a production server, since distro and project versions move over time.

  1. 1Get the source and enter the docker directory

    git clone https://github.com/healthchecks/healthchecks.git
    cd healthchecks/docker

  2. 2Configure environment variables

    Edit .env to set ALLOWED_HOSTS, DEFAULT_FROM_EMAIL, EMAIL_HOST/EMAIL_HOST_USER/EMAIL_HOST_PASSWORD, a random SECRET_KEY, and SITE_ROOT.

    cp .env.example .env

  3. 3Start the stack

    docker compose up

  4. 4Create a superuser account

    docker compose run web /opt/healthchecks/manage.py createsuperuser --email [email protected] --password changeme123

    Put a TLS-terminating reverse proxy in front for production — the images do not handle TLS themselves. Default access: http://localhost:8000