---
title: "Deploy Checkmate"
description: "Checkmate 3.12: uptime and infrastructure monitoring with status pages."
category: "Observability"
url: https://railway.com/deploy/checkmate-1
---

# Deploy Checkmate

Checkmate 3.12: uptime and infrastructure monitoring with status pages.

**[Deploy Checkmate on Railway](https://railway.com/template/checkmate-1)**

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

- **Creator:** Agaz Self-Host
- **Category:** Observability

## Template content

### checkmate https://raw.githubusercontent.com/bluewave-labs/checkmate/v3.12.0/client/public/checkmate_favicon.svg

- **Image:** ghcr.io/bluewave-labs/checkmate:v3.12.0
- **Start command:** `sh -c 'printf "%s\n" "$CHECKMATE_SEED" > /tmp/seed.mjs; node dist/index.js & pid=$!; trap "kill -TERM $pid; wait $pid; exit 0" TERM INT; node /tmp/seed.mjs & wait $pid'`
- **Health check:** /api/v1/auth/users/superadmin
- **Public domain:** Yes

### MongoDB https://devicons.railway.app/i/mongodb.svg

- **Image:** mongo:8.0
- **Start command:** `docker-entrypoint.sh mongod --ipv6 --bind_ip ::,0.0.0.0 --setParameter diagnosticDataCollectionEnabled=false`

## Documentation

# 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

- [Checkmate on GitHub](https://github.com/bluewave-labs/checkmate)
- [Checkmate v3.12.0 release](https://github.com/bluewave-labs/checkmate/releases/tag/v3.12.0)
- [Railway MongoDB](https://docs.railway.com/guides/mongodb)

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


## 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/checkmate-1