Deploy Healthchecks

Healthchecks 4.4 cron job monitoring with ping URLs and alerts.

Deploy Healthchecks

/var/lib/postgresql/data

Just deployed

Deploy and Host Healthchecks on Railway

Healthchecks is a cron job and background task monitor. Each job gets a unique ping URL; when a ping arrives late or reports a failure, Healthchecks alerts you by email, Slack, Discord, Telegram, webhooks and many other integrations. It is the open-source code behind the healthchecks.io service.

About Hosting Healthchecks

This template deploys Healthchecks v4.4 from the official image with a Railway Postgres database. The start command runs database migrations and creates the admin account from environment variables, so the first login works immediately; public sign-up is closed. Ping URLs use your Railway domain. The service listens on IPv4 and IPv6, so jobs on the same project can ping over the private network. Email alerts need an SMTP server: set EMAIL_HOST and related variables. The app is light and fits on the Hobby plan. Back up Postgres regularly to keep the check history.

Common Use Cases

  • Alerting when cron jobs, backups or scheduled tasks stop running
  • Monitoring background workers and queues with start and fail signals
  • A self-hosted dead man's switch for home-lab and production jobs

Dependencies for Healthchecks Hosting

  • healthchecks/healthchecks:v4.4 (official image)
  • Railway Postgres (ghcr.io/railwayapp-templates/postgres-ssl:18) with a volume

Deployment Dependencies

Implementation Details

ServiceImageNetworkingStorage
healthcheckshealthchecks/healthchecks:v4.4public domain on 8000; private IPv4/IPv6none (state in Postgres)
PostgresRailway Postgres 18private onlyvolume

Ping a check from a job:

./backup.sh && curl -fsS -m 10 --retry 5 https:///ping/
VariableDefaultPurpose
HC_ADMIN_EMAIL / HC_ADMIN_PASSWORDadmin@example.com / generatedAdmin login, created on first start
REGISTRATION_OPENFalseKeep public sign-up closed
ALLOWED_HOSTSpublic, private and health-check hostsDjango host allow list

Notes:

  • healthcheck.railway.app must stay in ALLOWED_HOSTS, because Railway's health check uses it as the Host header.
  • Changing HC_ADMIN_PASSWORD later does not change an existing account; use the web UI.

This is a community-maintained deployment package and does not imply affiliation with or endorsement by the Healthchecks project or its maintainers.

Why Deploy Healthchecks on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Healthchecks on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


Template Content

More templates in this category

View Template
NEW
Rootprint
Open-source logs and traces with full-text search on object-storage.

Rootprint
1
View Template
Pyroscope profiling
Protected continuous profiling with durable Pyroscope storage.

Anton Orel
1
View Template
SigOnly
Deploy SigNoz with a working demo app & config in one click

zoeyjones
22