Deploy and Host Checkmate on Railway

Checkmate is an open-source uptime and infrastructure monitoring tool. It checks websites, APIs, ports, Docker containers and game servers, measures response times, tracks incidents, and publishes status pages. With its optional Capture agent it also reports CPU, memory, disk and network usage from your servers.

About Hosting Checkmate

This template runs the official ghcr.io/bluewave-labs/checkmate:v3.12.0 image (API and web app in one) with a Railway MongoDB database. The first account in Checkmate becomes the superadmin, so the start command creates it on first boot from CHECKMATE_ADMIN_EMAIL and a generated password; after that, new users need an invite. Monitors, checks and incidents are stored in MongoDB, so they survive redeploys. JWT and encryption keys are generated. It fits the Hobby plan for a few dozen monitors. Ping monitors need raw sockets, which Railway may not allow, so prefer HTTP and port checks.

Common Use Cases

Uptime monitoring with alerts for websites and APIs
Public status pages for customers
Server resource monitoring with the Capture agent

Dependencies for Checkmate Hosting

ghcr.io/bluewave-labs/checkmate:v3.12.0 (official image)
Railway MongoDB

Deployment Dependencies

Implementation Details

Service	Source	Networking	Storage
checkmate	`ghcr.io/bluewave-labs/checkmate:v3.12.0`	public domain on 52345	none (data in MongoDB)
MongoDB	Railway MongoDB	private	Railway volume

Variable	Default	Purpose
`CHECKMATE_ADMIN_EMAIL`	`admin@example.com`	Superadmin created on first boot
`CHECKMATE_ADMIN_PASSWORD`	`Cm1!` + generated	Its password (meets the password rules)
`JWT_SECRET`	generated	Signs sessions
`ENCRYPTION_KEY`	generated	Encrypts stored notification secrets
`CLIENT_HOST`	`https://`	Public URL

Notes:

The seed only runs while no superadmin exists; later changes to the admin variables have no effect.
Invite teammates from Settings → Team.

This is a community-maintained deployment package and does not imply affiliation with or endorsement by Bluewave Labs or the Checkmate project.

Why Deploy Checkmate 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 Checkmate 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.