---
title: "Deploy Healthchecks"
description: "Cron job monitoring: get alerted when a scheduled job doesn't check in"
category: "Observability"
url: https://railway.com/deploy/healthchecks-3
---

# Deploy Healthchecks

Cron job monitoring: get alerted when a scheduled job doesn't check in

**[Deploy Healthchecks on Railway](https://railway.com/template/healthchecks-3)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/healthchecks-3/manifest.json

- **Creator:** Connor Prussin's Projects
- **Category:** Observability

## Template content

### Healthchecks https://raw.githubusercontent.com/healthchecks/healthchecks/master/static/img/logo.png

- **Image:** healthchecks/healthchecks:v4.4
- **Health check:** /api/v3/status/
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

## Documentation

# Deploy and Host Healthchecks on Railway

[Healthchecks](https://github.com/healthchecks/healthchecks) monitors cron jobs and background tasks. Each job pings a unique URL when it runs, and if a ping is late, Healthchecks alerts you. Alerts go to Slack, Discord, Telegram, email, webhooks, ntfy, PagerDuty and 20+ other channels.

## About Hosting Healthchecks

This template runs the official `healthchecks/healthchecks` image (uWSGI + Django) with Railway Postgres. On every deploy, a pre-deploy step runs the database migrations and creates your admin account from `ADMIN_EMAIL` and `ADMIN_PASSWORD`. You can log in immediately, with no shell and no SMTP needed. Public sign-up is off by default.

The alert sender (`sendalerts`) and the report sender (`sendreports`) run inside the same container, so there is only one app service to pay for.

## Common Use Cases

- Know when a nightly backup, cron script or Railway cron service silently stops running.
- Monitor background workers and queues with start and finish pings that track run time.
- Give a team a shared dashboard and status badges for scheduled jobs.

## Dependencies for Healthchecks Hosting

- PostgreSQL (included)

### Deployment Dependencies

- Upstream: 
- Self-hosting docs: 
- Configuration reference: 

### Implementation Details

| Variable                         | Default                                   | Notes                                          |
| -------------------------------- | ----------------------------------------- | ---------------------------------------------- |
| `ADMIN_EMAIL`                    | (you set it)                              | Superuser login                                |
| `ADMIN_PASSWORD`                 | random                                    | Copy it from the service's Variables tab       |
| `SITE_ROOT`                      | `https://${{RAILWAY_PUBLIC_DOMAIN}}`      | Change it if you add a custom domain           |
| `ALLOWED_HOSTS`                  | public domain + `healthcheck.railway.app` | Add your custom domain here too                |
| `REGISTRATION_OPEN`              | `False`                                   | Set `True` to allow public sign-up             |
| `EMAIL_HOST` and other `EMAIL_*` | empty                                     | Optional SMTP for email alerts and invites     |
| `UWSGI_PROCESSES`                | `2`                                       | Keeps RAM low; raise it for heavy ping traffic |

- Pings: `https:///ping/`. Use `curl -fsS -m 10 --retry 5 -o /dev/null ` at the end of a job.
- Healthcheck: Railway probes `/api/v3/status/`, which also checks the database connection.
- Email: some Railway plans restrict outbound SMTP. Chat, webhook and push integrations work without email.
- Changing `ADMIN_PASSWORD` later doesn't reset an existing account. Change your password in the UI instead.

## Why Deploy Healthchecks on Railway?

Railway is a single platform for deploying your whole stack: servers, databases, AI agents and more. It handles the infrastructure, so you don't have to manage servers or configure scaling.

When you deploy Healthchecks on Railway, you're one step closer to running your full stack with minimal effort. Host your servers, databases, AI agents and more on Railway.


## Similar templates

- [Rootprint](https://railway.com/deploy/rootprint-1) — Open-source logs and traces with full-text search on object-storage.
- [Pyroscope profiling](https://railway.com/deploy/pyroscope-profiling) — Protected continuous profiling with durable Pyroscope storage.
- [SigOnly](https://railway.com/deploy/sigonly) — Deploy SigNoz with a working demo app & config in one click

Open this page in a browser: https://railway.com/deploy/healthchecks-3