--- title: "Deploy Healthchecks" description: "Cron Job Monitoring Service" category: "Observability" url: https://railway.com/deploy/healthchecks --- # Deploy Healthchecks Cron Job Monitoring Service **[Deploy Healthchecks on Railway](https://railway.com/template/healthchecks)** - **Creator:** victorrocco's Projects - **Category:** Observability - **Total deploys:** 30 ## Template content ### Healthchecks https://experto-ai-shared-public-images.s3.us-east-2.amazonaws.com/railway/healthchecks.svg - **Source:** Experto-AI/railway-healthchecks - **Health check:** /api/v3/status/ - **Public domain:** Yes ### Postgres https://devicons.railway.app/i/postgresql.svg - **Image:** ghcr.io/railwayapp-templates/postgres-ssl:17 ## Documentation # Deploy and Host Healthchecks on Railway **Healthchecks** is a self-hosted cron job monitoring service. It listens for HTTP requests (pings) from your scheduled tasks and sends alerts when they don't arrive on time. Use Healthchecks to: - Monitor background jobs and cron tasks - Get instant alerts when tasks fail or miss their schedule - Track job performance and execution time - Receive notifications via email, Slack, Discord, PagerDuty, and 20+ other integrations Don't use Healthchecks to monitor uptime of websites or services. It's specifically designed for monitoring scheduled tasks. ![Healthchecks Dashboard](https://raw.githubusercontent.com/healthchecks/healthchecks/master/static/img/my_checks.png?raw=true) ![Check Configuration](https://github.com/healthchecks/healthchecks/raw/master/static/img/period_grace.png?raw=true) ![Cron Schedule Setup](https://github.com/healthchecks/healthchecks/raw/master/static/img/cron.png?raw=true) ## About Hosting Healthchecks - **Healthchecks Web Application** - The main interface and API for managing checks - **PostgreSQL Database** - Persistent data storage with automatic backups - **Background Workers** - Automated alert delivery and report generation - **Health Monitoring** - Automatic health checks to ensure the system is running smoothly This Railway template comes with **Apprise enabled**, giving you access to 25+ notification services including: - **Slack** - Real-time notifications in Slack channels - **Discord** - Alerts in Discord servers - **Microsoft Teams** - Team notifications - **Telegram** - Bot notifications - **PagerDuty** - Incident management integration - **Opsgenie** - Alert routing - **Twilio** - SMS alerts - **Signal** - Signal messages - And 15+ more services... ## Common Use Cases Use Healthchecks to: - Monitor background jobs and cron tasks - Get instant alerts when tasks fail or miss their schedule - Track job performance and execution time - Receive notifications via email, Slack, Discord, PagerDuty, and 20+ other integrations Don't use Healthchecks to monitor uptime of websites or services. It's specifically designed for monitoring scheduled tasks. ## Dependencies for Healthchecks Hosting - **Railway Account:** You'll need a Railway account to deploy this template. A PRO or Enterprise plan is recommended for SMTP support. A Free or Hobby plan can be used but SMTP will not work. You still can use other notification methods (Slack, Discord, etc.). If you don't have an account, sign up at [railway.com](https://railway.com?referralCode=ExpertoAI). - **Email Sender Provider:** An email provider is **necessary** for the complete setup. We recommend **Resend**, and all default values are provided for it in this template—however, you **must provide your own API KEY**. - **(Optional) Other SMTP Providers:** While we recommend Resend, any SMTP-compatible provider is supported (e.g., SendGrid, Mailgun, Gmail). Note that using a different provider will require changing more environment variables during deployment. - **Valid User Email:** You must provide a valid email address during deployment. This will be used for your **first login** and to receive system notifications. - **Admin Password:** You must set a password for your admin account during the deployment process. ### Deployment Dependencies Read official documentation to learn how to create checks, set up notifications, monitor your cron jobs effectively and troubleshoot common issues. Visit [Healthchecks Documentation](https://healthchecks.io/docs/). Official Github Repository: [https://github.com/healthchecks/healthchecks](https://github.com/healthchecks/healthchecks) ### Implementation Details **Default Configuration (Resend - Minimal Setup)** This template comes pre-configured with **Resend** as the email provider. For the default setup, you only need to provide: 1. **Valid User Email** - Your email address for login and notifications 2. **Admin Password** - Your admin account password Optional: 3. **Resend API Key** - Sign up at [Resend.com](https://resend.com), get your API key from the dashboard, and provide it as `EMAIL_HOST_PASSWORD` That's it! All other SMTP settings are pre-configured for Resend: - `EMAIL_HOST` = `smtp.resend.com` - `EMAIL_PORT` = `587` - `EMAIL_HOST_USER` = `resend` - `EMAIL_USE_TLS` = `True` - `EMAIL_USE_SSL` = `False` **Using Alternative Email Providers** If you prefer to use another provider like **SendGrid**, **Mailgun**, or **Gmail**, you will need to configure additional environment variables during deployment or in the Railway variables dashboard: - `EMAIL_HOST` - Your provider's SMTP host - `EMAIL_PORT` - Your provider's SMTP port (typically 587 or 465) - `EMAIL_HOST_USER` - Your provider's username or email - `EMAIL_HOST_PASSWORD` - Your provider's password or API key - `EMAIL_USE_TLS` / `EMAIL_USE_SSL` - Security settings (depends on provider) **Note for Gmail:** Requires an [App Password](https://support.google.com/accounts/answer/185833) instead of your regular password. Enable 2-Factor Authentication first. ## 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. ## Similar templates - [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 - [Unwrapped Spotify Music Stats](https://railway.com/deploy/wide-bold) — Unwrapped Spotify Music Stats, Estatísticas de músicas disponíveis Open this page in a browser: https://railway.com/deploy/healthchecks