Self-host Healthchecks on a VPS
Cron job and scheduled task monitoring: get alerted the moment a periodic job stops checking in.
levelrail-cli templates deploy healthchecks --name my-healthchecksSpecification
- Status
- Listed
- Category
- Monitoring
- Services
- db, healthchecks
- Ports
- 8000
- Volumes
- 1
- Memory
- about 256 MiB
- arm64
- image published
- amd64
- image published
- Settings to fill in
- none
- License
- Permissive license, BSD-3-Clause
About Healthchecks
Cron job and scheduled task monitoring: get alerted the moment a periodic job stops checking in. Runs 2 containers (db, healthchecks), with healthchecks listening on port 8000; data is kept in named volumes.
What it deploys
Healthchecks runs as 2 services in a single Compose app, listening on port 8000, with 1 named volume mount.
| Service | Image | Tag | Ports | Volumes |
|---|---|---|---|---|
| db | postgres | 16-alpine | none | healthchecks_db_data -> /var/lib/postgresql/data |
| healthchecks | healthchecks/healthchecks | v4.2 | 8000 | none |
Before you install
- CPU architecture. arm64 listed. Every image lists linux/arm64 in its registry manifest. That is a manifest fact, not proof the app runs on Arm.
- Listed. It is in the catalog. Back up the data volume before changing an image tag.
- Host ports. It publishes port 8000 directly on the host, so open them in the VPS firewall only if you want that.
Settings and environment
You do not have to fill in anything. 3 secrets are generated at deploy and stored encrypted. Values are never shown here.
| Service | Variable | Value |
|---|---|---|
| db | POSTGRES_DB | Preset by the template |
| db | POSTGRES_PASSWORD | Generated at deploy |
| db | POSTGRES_USER | Preset by the template |
| healthchecks | ALLOWED_HOSTS | Preset by the template |
| healthchecks | DB | Preset by the template |
| healthchecks | DB_HOST | Preset by the template |
| healthchecks | DB_NAME | Preset by the template |
| healthchecks | DB_PASSWORD | Generated at deploy |
| healthchecks | DB_USER | Preset by the template |
| healthchecks | SECRET_KEY | Generated at deploy |
Install Healthchecks on a VPS
-
Install Levelrail on a fresh VPS
Run this as root on a Linux server (amd64 or arm64) with ports 80 and 443 reachable. The installer prints a setup link.
curl -fsSL https://levelrail.com/install.sh | sudo sh -
Sign in
Open the setup link, choose a password, then log the CLI in. The CLI install command is
curl -fsSL https://levelrail.com/install-cli.sh | shif the machine does not have it. See Getting started.levelrail-cli login --device -
Read the template
Shows the entry, including its full compose.yaml.
levelrail-cli templates get healthchecks -
Deploy it
This deploys the template compose file as an app. The app name defaults to the template id; --name sets another.
levelrail-cli templates deploy healthchecks --name my-healthchecks
Without a domain the app gets an sslip.io address. You can also deploy it from the dashboard: Apps, New app, Browse templates, then Healthchecks.
Docs and upstream
More in Monitoring
- HertzBeatA real time monitoring system with agentless collection, alerts and a web console, on the embedded database with a data volume. Change the default login after the first sign in.
- Grafana TempoDistributed tracing backend that stores traces on local disk and accepts OTLP over gRPC and HTTP. The install form carries tempo.yaml as an editable file.
- Grafana OTel LGTMAn all-in-one OpenTelemetry backend with an OTLP collector, Loki logs, Tempo traces, Prometheus metrics and Grafana in one container. The Grafana admin password is generated at install. OTLP ports are not published on the host, so send telemetry from other services in this project to otel-lgtm:4317 (gRPC) or otel-lgtm:4318 (HTTP).
- Grafana MimirHorizontally scalable long term storage for Prometheus metrics, run here as one process on local disk. The install form carries mimir.yaml as an editable file.
- Grafana LokiA horizontally scalable log aggregation system that indexes labels, not full text, to keep storage cheap.
- HyperDXAn observability platform that brings logs, traces, metrics and session replays together in one search UI. MIT licensed. Runs the all-in-one image with its bundled ClickHouse, MongoDB and OpenTelemetry collector, so it needs about 2 GB of memory. On first open, the setup page asks you to create the admin login.