How do I deploy Healthchecks on Railway?

You can deploy Healthchecks on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: healthchecks-42007f0d, or join our Discord community for more assistance.

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

Check Configuration

Cron Schedule Setup

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.
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.

Official Github Repository: 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:

Valid User Email - Your email address for login and notifications
Admin Password - Your admin account password
Resend API Key - Sign up at 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 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.